Pular para o conteúdo principal
Obtém o nome de exibição amigável 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 nome de exibição 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 armazenar o nome de exibição, incluindo o terminador nulo.

Comentários

O método grava o nome de exibição 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 nome de exibição, 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 nome de exibição, o tamanho necessário será 1 e o método gravará uma cadeia de caracteres vazia. O nome de exibição é um nome “amigável” para o dispositivo. Você pode exibi-lo na interface do usuário do seu aplicativo, mas não há garantia de que ele esteja localizado. O GameInput pesquisa essa cadeia de caracteres em vários locais, e um dos últimos fallbacks é o firmware do dispositivo. O nome de exibição não muda durante o tempo de vida do objeto de dispositivo. O exemplo a seguir recupera o nome de exibição de um dispositivo.
No GameInput v3 e anteriores, essas informações estavam disponíveis no membro displayName 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::GetPnpPath

Histórico de versões

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