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 esnullptr 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.
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 SeriesConsulte también
Información general de GameInputIGameInputDevice
IGameInputDevice::GetDisplayName
IGameInputDevice::GetContainerId
