Saltar al contenido principal
Obtiene el nombre para mostrar descriptivo del dispositivo de entrada como una cadena UTF-8.

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 es nullptr 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.
En GameInput v3 y versiones anteriores, esta información estaba disponible en el miembro 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 Series

Consulte también

Información general de GameInput
IGameInputDevice
IGameInputDevice::GetPnpPath

Historial de versiones

Última modificación el 6 de noviembre de 2026