Syntaxe
Paramètres
infoArrayCount _In_Type : uint32_t Nombre d’éléments dans infoArray. Pour récupérer tous les rapports d’entrée, transmettez la valeur retournée par GetInputReportCount. infoArray _Out_writes_to_opt_(infoArrayCount, return)
Type : GameInputRawDeviceReportInfo* Pointeur vers un tableau qui reçoit une structure par rapport d’entrée. Peut être
nullptr; dans ce cas, rien n’est écrit et la méthode retourne 0.
Valeur de retour
Type : uint32_t Le nombre d’éléments écrits dans infoArray. Il s’agit de la plus petite valeur entre infoArrayCount et le nombre de rapports d’entrée du périphérique, ou 0 si infoArray estnullptr ou si le périphérique n’a aucun rapport d’entrée.
Remarques
Chaque élément est une structure GameInputRawDeviceReportInfo dont le membrekind vaut GameInputRawInputReport, dont le membre id est l’ID de rapport défini par le périphérique et dont le membre size est la taille des données du rapport, en octets.
Appelez GetInputReportCount pour obtenir le nombre de rapports d’entrée, allouez un tableau de cette taille, puis appelez GetInputReportInfo pour le remplir. Si infoArrayCount est inférieur au nombre de rapports d’entrée, seuls les infoArrayCount premiers éléments sont écrits. Les rapports d’entrée d’un périphérique ne changent pas tant que le périphérique est connecté; vous pouvez donc les interroger une seule fois et mettre le résultat en cache.
Le membre id de chaque élément correspond à l’ID de rapport retourné par IGameInputRawDeviceReport::GetReportInfo pour les rapports bruts que IGameInputReading::GetRawReport retourne à partir des lectures de ce périphérique.
L’exemple suivant montre comment récupérer les rapports d’entrée d’un périphérique.
inputReportInfo 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 GameInputGetInputReportCount
GameInputRawDeviceReportInfo
GameInputRawDeviceReportKind
IGameInputRawDeviceReport
IGameInputReading::GetRawReport
Rubriques avancées sur GameInput
IGameInputDevice
