Passer au contenu principal
Envoie un rapport de fonctionnalité brut au périphérique.

Syntaxe

Paramètres

report   _In_
Type : IGameInputRawDeviceReport*
Le rapport de fonctionnalité à envoyer. Créez-le en appelant CreateRawDeviceReport avec GameInputRawFeatureReport, puis remplissez-le en appelant IGameInputRawDeviceReport::SetRawData.

Valeur de retour

Type : HRESULT Retourne S_OK si le rapport a été soumis au périphérique. Retourne GAMEINPUT_E_AGGREGATE_OPERATION_NOT_SUPPORTED si le périphérique est un périphérique agrégé, ou un autre code d’erreur si le rapport ne peut pas être soumis.

Remarques

La méthode SetRawDeviceFeature écrit un rapport de fonctionnalité sur le périphérique. L’ID de rapport provient de la structure GameInputRawDeviceReportInfo du rapport, et la charge utile correspond aux données définies avec IGameInputRawDeviceReport::SetRawData. Utilisez GetFeatureReportCount et GetFeatureReportInfo pour découvrir quels rapports de fonctionnalité un périphérique définit et quelle est la taille de chacun. Les rapports de fonctionnalité sont actuellement exposés pour les périphériques HID. Pour les périphériques HID, le premier octet des données du rapport est l’ID de rapport. SetRawDeviceFeature met le rapport en file d’attente pour livraison et retourne sans attendre que le périphérique le traite. Une valeur de retour indiquant la réussite signifie que le rapport a été soumis, et non que le périphérique l’a accepté. Pour confirmer le nouvel état, relisez le rapport en appelant GetRawDeviceFeature.
Pour les cas d’utilisation intermédiaires et avancés de l’API GameInput, consultez Rubriques avancées sur GameInput.

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
GetRawDeviceFeature
GetFeatureReportCount
GetFeatureReportInfo
CreateRawDeviceReport
IGameInputRawDeviceReport
IGameInputDevice

Historique des versions

Annexe : versions précédentes

v0

Dans GameInput v0, cette méthode était déclarée avec la même signature, mais n’était pas implémentée. Pour plus d’informations, consultez IGameInputDevice::SetRawDeviceFeature (déconseillé).
Dernière modification le 6 novembre 2026