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 clavier, tous les membres de la structure sont définis sur zéro.

Valeur de retour

Type : bool true si le périphérique prend en charge l’entrée clavier et que info a été renseigné ; 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 clavier lorsque la valeur retournée par GetSupportedInput inclut GameInputKindKeyboard. Si le périphérique ne prend pas en charge l’entrée 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 d’entrée). Lorsque la disposition change, GameInput déclenche l’événement GameInputDeviceEvent GameInputDeviceEventKeyboardLayoutUpdated vers les rappels de périphérique inscrits avec IGameInput::RegisterDeviceCallback. Appelez à nouveau GetKeyboardInfo depuis 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 via 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