Syntaxe
Paramètres
infoArrayCount _In_Type : uint32_t Nombre d’éléments de infoArray. Pour récupérer tous les rapports de fonctionnalité, transmettez la valeur retournée par GetFeatureReportCount. infoArray _Out_writes_to_opt_(infoArrayCount, return)
Type : GameInputRawDeviceReportInfo* Pointeur vers un tableau qui reçoit une structure par rapport de fonctionnalité. Peut être
nullptr, auquel cas rien n’est écrit et la méthode retourne 0.
Valeur de retour
Type : uint32_t Nombre d’éléments écrits dans infoArray. Il s’agit de la plus petite valeur entre infoArrayCount et le nombre de rapports de fonctionnalité du périphérique, ou de 0 si infoArray estnullptr ou si le périphérique n’a aucun rapport de fonctionnalité.
Remarques
Chaque élément est une structure GameInputRawDeviceReportInfo dont le membrekind vaut GameInputRawFeatureReport, dont le membre id est l’ID de rapport défini par le périphérique et dont le membre size correspond à la taille des données du rapport, en octets.
Appelez GetFeatureReportCount pour obtenir le nombre de rapports de fonctionnalité, allouez un tableau de cette taille, puis appelez GetFeatureReportInfo pour le remplir. Si infoArrayCount est inférieur au nombre de rapports de fonctionnalité, seuls les infoArrayCount premiers éléments sont écrits. Les rapports de fonctionnalité 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.
Utilisez le membre id d’un élément comme paramètre reportId de GetRawDeviceFeature pour lire le rapport, ou de CreateRawDeviceReport, avec GameInputRawFeatureReport, pour créer un rapport que vous pouvez envoyer avec SetRawDeviceFeature. Le membre size indique le nombre d’octets des données du rapport.
L’exemple suivant montre comment récupérer les rapports de fonctionnalité d’un périphérique.
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 GameInputGetFeatureReportCount
GameInputRawDeviceReportInfo
GameInputRawDeviceReportKind
IGameInputRawDeviceReport
GetRawDeviceFeature
SetRawDeviceFeature
CreateRawDeviceReport
Rubriques avancées sur GameInput
IGameInputDevice
