Pular para o conteúdo principal
Recupera as propriedades de teclado do dispositivo, como o tipo de teclado, o layout e o número de teclas.

Sintaxe

Parâmetros

info   _Out_
Tipo: GameInputKeyboardInfo*
Ponteiro para uma estrutura GameInputKeyboardInfo que recebe as propriedades de teclado do dispositivo. Se o dispositivo não oferecer suporte à entrada de teclado, todos os membros da estrutura serão definidos como zero.

Valor retornado

Tipo: bool true se o dispositivo oferecer suporte à entrada de teclado e info tiver sido preenchido; caso contrário, false.

Comentários

O método GetKeyboardInfo copia as propriedades de teclado do dispositivo para a estrutura fornecida pelo chamador. Um dispositivo oferece suporte à entrada de teclado quando o valor retornado por GetSupportedInput inclui GameInputKindKeyboard. Se o dispositivo não oferecer suporte à entrada de teclado, GetKeyboardInfo inicializará info com zeros e retornará false. A maioria das propriedades de teclado é fixa durante o tempo de vida do dispositivo. A exceção é o membro layout, que o GameInput atualiza no local quando o layout de teclado ativo muda (por exemplo, quando o usuário alterna entre idiomas de entrada). Quando o layout muda, o GameInput gera o GameInputDeviceEvent GameInputDeviceEventKeyboardLayoutUpdated para os retornos de chamada de dispositivo registrados com IGameInput::RegisterDeviceCallback. Chame GetKeyboardInfo novamente a partir desse retorno de chamada para ler o novo layout. O exemplo a seguir mostra como consultar as propriedades de teclado de um dispositivo.
No GameInput v3 e anteriores, essas informações estavam disponíveis no membro keyboardInfo 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
GameInputKeyboardInfo
GetSupportedInput
GameInputKind
IGameInput::RegisterDeviceCallback
GameInputDeviceEvent
IGameInputReading::GetKeyState
IGameInputDevice

Histórico de versões

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