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 fornullptr 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.
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 SeriesConfira também
Visão geral do GameInputIGameInputDevice
IGameInputDevice::GetDisplayName
IGameInputDevice::GetContainerId
