IGameInputReading::GetKeyState
Récupère l’état des touches actives d’une entrée clavier.Syntaxe
Paramètres
stateArrayCount _In_Type : uint32_t Retourne le nombre de touches actives sur un clavier. Cette valeur s’obtient en appelant la méthode IGameInputReading::GetKeyCount. stateArray _Out_writes_(stateArrayCount) Type : GameInputKeyState* Pointeur vers la structure GameInputKeyState*.
Valeur de retour
Type : uint32_t Nombre d’entrées de mémoire tampon valides.Remarques
La méthodeIGameInputReading::GetKeyState récupère l’état des touches actives d’une entrée de manette de jeu. L’état rudimentaire du clavier est uniquement destiné à mapper l’entrée clavier sur des actions de jeu, comme le déplacement ou le tir avec une arme. Il n’est pas destiné à la saisie de texte classique. Un jeu nécessite une quantité de code importante en plus de cet état pour implémenter un élément aussi simple qu’une zone de texte (sans parler de fonctionnalités complexes comme les IME). D’autres API doivent être utilisées lorsque cette fonctionnalité est souhaitée.
L’état de chaque touche n’est pas stocké à un index fixe dans le tableau. Le nombre d’éléments valides du tableau augmente à mesure que des touches sont enfoncées et diminue à mesure qu’elles sont relâchées. Les nouvelles touches sont ajoutées à la fin du tableau et, lorsqu’une touche est relâchée, tous les éléments sont décalés vers le bas pour combler l’espace. Le premier élément du tableau dont les valeurs scancode et vkey sont toutes deux nulles indique la fin des données valides du tableau. Les claviers standard ne peuvent signaler que quatre à six appuis de touche à la fois, et même les claviers de jeu haut de gamme prennent rarement en charge plus de 12 à 16 touches simultanément. Par conséquent, cette approche permet généralement de limiter la taille maximale du tableau (la taille maximale peut être interrogée via l’interface IGameInputDevice). C’est beaucoup plus efficace que de faire parcourir aux applications un tableau de 256 valeurs chaque fois qu’elles vérifient l’état du clavier.
Configuration requise
En-tête : GameInput.h Rubriques GameInput avancéesVue d’ensemble de GameInput
IGameInputReading