構文
パラメーター
reportId _In_型: uint32_t 読み取る機能レポートの ID。GetFeatureReportInfo から返されるいずれかのレポートの
id メンバーと一致する必要があります。
report _COM_Outptr_型: IGameInputRawDeviceReport** デバイスから読み取られた機能レポート データを格納する新しい
IGameInputRawDeviceReport オブジェクトを受け取ります。失敗した場合は nullptr に設定されます。
戻り値
型: HRESULT 成功した場合はS_OK を返します。指定された ID の機能レポートがデバイスで定義されていない場合は E_NOTFOUND を返し、デバイスが集約デバイスの場合は GAMEINPUT_E_AGGREGATE_OPERATION_NOT_SUPPORTED を返します。デバイスからレポートを読み取れない場合は、その他のエラー コードを返します。
解説
GetRawDeviceFeature メソッドは、機能レポートの現在の内容をデバイスに要求し、新しい IGameInputRawDeviceReport オブジェクトで返します。レポートの GameInputRawDeviceReportInfo の kind メンバーは GameInputRawFeatureReport で、そのデータ サイズは GetFeatureReportInfo から返される対応する要素の size メンバーと一致します。データを読み取るには、GetRawDataSize と IGameInputRawDeviceReport::GetRawData を呼び出します。
デバイスが定義する機能レポートを調べるには、GetFeatureReportCount と GetFeatureReportInfo を使用します。現在、機能レポートは HID デバイスに対して公開されています。HID デバイスの場合、レポート データの最初のバイトはレポート ID です。
他の生のレポート メソッドとは異なり、GetRawDeviceFeature はデバイスが応答するまで待機してから戻るため、レンダー スレッドや入力ポーリング スレッドなど、時間的制約のあるスレッドでは呼び出さないでください。
要件
ヘッダー: GameInput.h ライブラリ: gameinput.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体、XBOX Series 本体関連項目
GameInput の概要SetRawDeviceFeature
GetFeatureReportCount
GetFeatureReportInfo
IGameInputRawDeviceReport
CreateRawDeviceReport
IGameInputDevice