Pular para o conteúdo principal
Obtém o caminho de dispositivo Plug and Play (PnP) do dispositivo de entrada como uma cadeia de caracteres UTF-8.

Sintaxe

Parâmetros

bufferByteCount   _In_
Tipo: uint32_t
O tamanho, em bytes, do buffer apontado por buffer. Passe 0 para consultar o tamanho necessário. buffer   _Out_writes_bytes_opt_(bufferByteCount)
Tipo: char*
O buffer que recebe o caminho PnP em UTF-8 terminado em nulo. Passe nullptr para consultar o tamanho necessário.

Valor retornado

Tipo: uint32_t O tamanho, em bytes, do buffer necessário para conter o caminho PnP, incluindo o terminador nulo.

Comentários

O método grava o caminho PnP em buffer somente se buffer não for nullptr e bufferByteCount for maior ou igual ao tamanho necessário. Caso contrário, o buffer não é modificado. Para recuperar o caminho, chame o método uma vez com bufferByteCount igual a 0 e buffer igual a nullptr para obter o tamanho necessário, aloque um buffer desse tamanho e, em seguida, chame o método novamente. Se o dispositivo não tiver um caminho PnP, o tamanho necessário será 1 e o método gravará uma cadeia de caracteres vazia. Use o caminho PnP para referenciar o dispositivo subjacente por meio de outras APIs. Como o caminho é codificado em UTF-8, converta-o para UTF-16 (por exemplo, usando MultiByteToWideChar com CP_UTF8) antes de passá-lo para APIs do Windows que esperam cadeias de caracteres largos. O caminho PnP não muda durante o tempo de vida do objeto de dispositivo. O exemplo a seguir recupera o caminho PnP de um dispositivo.
No GameInput v3 e anteriores, essas informações estavam disponíveis no membro pnpPath da estrutura GameInputDeviceInfo retornada por IGameInputDevice::GetDeviceInfo.

Requisitos

Cabeçalho: GameInput.h Biblioteca: gameinput.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Confira também

Visão geral do GameInput
IGameInputDevice
IGameInputDevice::GetDisplayName
IGameInputDevice::GetContainerId

Histórico de versões

Última modificação em 6 de novembro de 2026