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 : booltrue si le périphérique prend en charge l’entrée clavier et que info a été renseigné ; sinon, false.
Remarques
La méthodeGetKeyboardInfo 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.
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 SeriesVoir aussi
Vue d’ensemble de GameInputGameInputKeyboardInfo
GetSupportedInput
GameInputKind
IGameInput::RegisterDeviceCallback
GameInputDeviceEvent
IGameInputReading::GetKeyState
IGameInputDevice
