Sintaxis
Parámetros
bufferByteCount _In_Tipo: uint32_t El tamaño, en bytes, del búfer al que apunta buffer. Pase 0 para consultar el tamaño necesario. buffer _Out_writes_bytes_opt_(bufferByteCount)
Tipo: char* El búfer que recibe el nombre para mostrar UTF-8 terminado en NULL. Pase
nullptr para consultar el tamaño necesario.
Valor devuelto
Tipo: uint32_t El tamaño, en bytes, del búfer necesario para contener el nombre para mostrar, incluido el terminador NULL.Comentarios
El método escribe el nombre para mostrar en buffer solo si buffer no esnullptr y bufferByteCount es mayor o igual que el tamaño necesario. De lo contrario, el búfer no se modifica. Para recuperar el nombre para mostrar, llame al método una vez con un valor de bufferByteCount de 0 y un valor de buffer de nullptr para obtener el tamaño necesario, asigne un búfer de ese tamaño y, a continuación, vuelva a llamar al método.
Si el dispositivo no tiene un nombre para mostrar, el tamaño necesario es 1 y el método escribe una cadena vacía.
El nombre para mostrar es un nombre “descriptivo” del dispositivo. Puede mostrarlo en la interfaz de usuario de la aplicación, pero no se garantiza que esté localizado. GameInput busca esta cadena en varias ubicaciones, y una de las últimas alternativas es el firmware del dispositivo.
El nombre para mostrar no cambia durante la vida útil del objeto de dispositivo.
En el siguiente ejemplo se recupera el nombre para mostrar de un dispositivo.
displayName de la estructura GameInputDeviceInfo devuelta por IGameInputDevice::GetDeviceInfo.
Requisitos
Encabezado: GameInput.h Biblioteca: gameinput.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX SeriesConsulte también
Información general de GameInputIGameInputDevice
IGameInputDevice::GetPnpPath
