Saltar al contenido principal
Obtiene la ruta de acceso de dispositivo Plug and Play (PnP) 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 la ruta de acceso PnP UTF-8 terminada 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 la ruta de acceso PnP, incluido el terminador NULL.

Comentarios

El método escribe la ruta de acceso PnP 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 la ruta de acceso, 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 una ruta de acceso PnP, el tamaño necesario es 1 y el método escribe una cadena vacía. Use la ruta de acceso PnP para hacer referencia al dispositivo subyacente a través de otras API. Dado que la ruta de acceso está codificada como UTF-8, conviértala a UTF-16 (por ejemplo, mediante MultiByteToWideChar con CP_UTF8) antes de pasarla a las API de Windows que esperan cadenas de caracteres anchos. La ruta de acceso PnP no cambia durante la vida útil del objeto de dispositivo. En el siguiente ejemplo se recupera la ruta de acceso PnP de un dispositivo.
En GameInput v3 y versiones anteriores, esta información estaba disponible en el miembro pnpPath 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::GetDisplayName
IGameInputDevice::GetContainerId

Historial de versiones

Última modificación el 6 de noviembre de 2026