IGameInputDevice::GetRawDeviceFeature

Lit un rapport de fonctionnalité brut à partir du périphérique.

Syntaxe

HRESULT GetRawDeviceFeature(
    uint32_t reportId,
    IGameInputRawDeviceReport** report
);

Paramètres

reportId _In_
Type : uint32_t ID du rapport de fonctionnalité à lire. Doit correspondre au membre id de l’un des rapports retournés par GetFeatureReportInfo. report _COM_Outptr_
Type : IGameInputRawDeviceReport** Reçoit un nouvel objet IGameInputRawDeviceReport qui contient les données du rapport de fonctionnalité lues à partir du périphérique. Défini sur nullptr en cas d’échec.

Valeur de retour

Type : HRESULT Retourne S_OK en cas de réussite. Retourne E_NOTFOUND si le périphérique ne définit aucun rapport de fonctionnalité avec l’ID spécifié, et GAMEINPUT_E_AGGREGATE_OPERATION_NOT_SUPPORTED si le périphérique est un périphérique agrégé. Retourne d’autres codes d’erreur si le rapport ne peut pas être lu à partir du périphérique.

Remarques

La méthode GetRawDeviceFeature demande au périphérique le contenu actuel d’un rapport de fonctionnalité et le retourne dans un nouvel objet IGameInputRawDeviceReport. Le membre kind de la structure GameInputRawDeviceReportInfo du rapport vaut GameInputRawFeatureReport, et la taille de ses données correspond au membre size de l’élément correspondant retourné par GetFeatureReportInfo. Lisez les données en appelant GetRawDataSize et IGameInputRawDeviceReport::GetRawData. Utilisez GetFeatureReportCount et GetFeatureReportInfo pour découvrir les rapports de fonctionnalité définis par un périphérique. 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. Contrairement aux autres méthodes de rapport brut, GetRawDeviceFeature attend la réponse du périphérique avant de retourner ; évitez donc de l’appeler sur des threads critiques en termes de temps, comme votre thread de rendu ou d’interrogation des entrées.

Microsoft::WRL::ComPtr<IGameInputRawDeviceReport> report;
if (SUCCEEDED(device->GetRawDeviceFeature(reportId, &report)))
{
    std::vector<uint8_t> data(report->GetRawDataSize());
    data.resize(report->GetRawData(data.size(), data.data()));
    // Parse the device-specific feature report data...
}

Pour les cas d’usage 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
SetRawDeviceFeature
GetFeatureReportCount
GetFeatureReportInfo
IGameInputRawDeviceReport
CreateRawDeviceReport
IGameInputDevice

Historique des versions

Version	Modifications
v4	Réintroduite.
v1	Supprimée.
v0	Introduite (non implémentée).

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::GetRawDeviceFeature (obsolète).

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

Additional pages

Reference

Syntaxe

Paramètres

Valeur de retour

Remarques

Configuration requise

Voir aussi

Historique des versions

Annexe : Versions précédentes

v0

​Syntaxe

​Paramètres

​Valeur de retour

​Remarques

​Configuration requise

​Voir aussi

​Historique des versions

​Annexe : Versions précédentes

​v0

Syntaxe

Paramètres

Valeur de retour

Remarques

Configuration requise

Voir aussi

Historique des versions

Annexe : Versions précédentes

v0