構文
パラメーター
infoArrayCount _In_型: uint32_t infoArray の要素数。すべての機能レポートを取得するには、GetFeatureReportCount から返された値を渡します。 infoArray _Out_writes_to_opt_(infoArrayCount, return)
型: GameInputRawDeviceReportInfo* 機能レポートごとに 1 つの構造体を受け取る配列へのポインター。
nullptr を指定できます。その場合、何も書き込まれず、メソッドは 0 を返します。
戻り値
型: uint32_t infoArray に書き込まれた要素の数。これは infoArrayCount とデバイス上の機能レポートの数のうち小さい方の値です。infoArray がnullptr の場合、またはデバイスに機能レポートがない場合は 0 です。
解説
各要素は GameInputRawDeviceReportInfo 構造体です。そのkind メンバーは GameInputRawFeatureReport、id メンバーはデバイスが定義するレポート ID、size メンバーはレポート データのサイズ (バイト単位) です。
GetFeatureReportCount を呼び出して機能レポートの数を取得し、そのサイズの配列を割り当ててから、GetFeatureReportInfo を呼び出して配列にデータを格納します。infoArrayCount が機能レポートの数より小さい場合は、先頭から infoArrayCount 個の要素のみが書き込まれます。デバイスが接続されている間、デバイスの機能レポートは変化しないため、一度クエリを実行して結果をキャッシュできます。
要素の id メンバーを GetRawDeviceFeature の reportId パラメーターとして使用するとレポートを読み取ることができます。また、GameInputRawFeatureReport と共に CreateRawDeviceReport の reportId パラメーターとして使用すると、SetRawDeviceFeature で送信できるレポートを作成できます。size メンバーは、レポート データのバイト数を示します。
次の例は、デバイスの機能レポートを取得する方法を示しています。
要件
ヘッダー: GameInput.h ライブラリ: gameinput.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体、XBOX Series 本体関連項目
GameInput の概要GetFeatureReportCount
GameInputRawDeviceReportInfo
GameInputRawDeviceReportKind
IGameInputRawDeviceReport
GetRawDeviceFeature
SetRawDeviceFeature
CreateRawDeviceReport
GameInput の高度なトピック
IGameInputDevice
