Passer au contenu principal
Récupère les propriétés de clavier du périphérique, comme son type de clavier, sa disposition et son nombre de touches.

Syntaxe

Paramètres

info   _Out_
Type : GameInputKeyboardInfo*
Pointeur vers une structure GameInputKeyboardInfo qui reçoit les propriétés de clavier du périphérique. Si le périphérique ne prend pas en charge l’entrée de clavier, chaque membre de la structure est mis à zéro.

Valeur de retour

Type : bool true si le périphérique prend en charge l’entrée de clavier et que info a été rempli; sinon, false.

Remarques

La méthode GetKeyboardInfo copie les propriétés de clavier du périphérique dans la structure fournie par l’appelant. Un périphérique prend en charge l’entrée de clavier lorsque la valeur retournée par GetSupportedInput inclut GameInputKindKeyboard. Si le périphérique ne prend pas en charge l’entrée de clavier, GetKeyboardInfo initialise info à zéro et retourne false. La plupart des propriétés de clavier sont fixes pendant toute la durée de vie du périphérique. L’exception est le membre layout, que GameInput met à jour sur place lorsque la disposition de clavier active change (par exemple, lorsque l’utilisateur change de langue de saisie). Lorsque la disposition change, GameInput déclenche l’événement GameInputDeviceEventKeyboardLayoutUpdated de type GameInputDeviceEvent vers les rappels de périphérique inscrits avec IGameInput::RegisterDeviceCallback. Appelez de nouveau GetKeyboardInfo à partir de ce rappel pour lire la nouvelle disposition. L’exemple suivant montre comment interroger les propriétés de clavier d’un périphérique.
Dans GameInput v3 et les versions antérieures, ces informations étaient disponibles dans le membre keyboardInfo de la structure GameInputDeviceInfo retournée par IGameInputDevice::GetDeviceInfo.

Configuration requise

En-tête : GameInput.h Bibliothèque : gameinput.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Voir aussi

Vue d’ensemble de GameInput
GameInputKeyboardInfo
GetSupportedInput
GameInputKind
IGameInput::RegisterDeviceCallback
GameInputDeviceEvent
IGameInputReading::GetKeyState
IGameInputDevice

Historique des versions

Dernière modification le 6 novembre 2026