Passer au contenu principal
Récupère les descriptions des rapports de sortie bruts définis par le périphérique.

Syntaxe

Paramètres

infoArrayCount   _In_
Type : uint32_t
Nombre d’éléments de infoArray. Pour récupérer tous les rapports de sortie, transmettez la valeur retournée par GetOutputReportCount. infoArray   _Out_writes_to_opt_(infoArrayCount, return)
Type : GameInputRawDeviceReportInfo*
Pointeur vers un tableau qui reçoit une structure par rapport de sortie. 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 sortie du périphérique, ou de 0 si infoArray est nullptr ou si le périphérique n’a aucun rapport de sortie.

Remarques

Chaque élément est une structure GameInputRawDeviceReportInfo dont le membre kind vaut GameInputRawOutputReport, 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 GetOutputReportCount pour obtenir le nombre de rapports de sortie, allouez un tableau de cette taille, puis appelez GetOutputReportInfo pour le remplir. Si infoArrayCount est inférieur au nombre de rapports de sortie, seuls les infoArrayCount premiers éléments sont écrits. Les rapports de sortie 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 CreateRawDeviceReport, avec GameInputRawOutputReport, pour créer un rapport de sortie que vous pouvez envoyer avec SendRawDeviceOutput. Le membre size indique le nombre d’octets de données de rapport attendus par le périphérique. L’exemple suivant montre comment récupérer les rapports de sortie d’un périphérique.
Dans GameInput v3 et les versions antérieures, ces informations étaient disponibles via le membre outputReportInfo 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
GetOutputReportCount
GameInputRawDeviceReportInfo
GameInputRawDeviceReportKind
IGameInputRawDeviceReport
CreateRawDeviceReport
SendRawDeviceOutput
Rubriques avancées sur GameInput
IGameInputDevice

Historique des versions

Dernière modification le 6 novembre 2026