メインコンテンツへスキップ
生の機能レポートをデバイスに送信します。

構文

パラメーター

report   _In_
型: IGameInputRawDeviceReport*
送信する機能レポート。GameInputRawFeatureReport を指定して CreateRawDeviceReport を呼び出して作成し、IGameInputRawDeviceReport::SetRawData を呼び出してデータを格納します。

戻り値

型: HRESULT レポートがデバイスに送信された場合は S_OK を返します。デバイスが集約デバイスの場合は GAMEINPUT_E_AGGREGATE_OPERATION_NOT_SUPPORTED を返し、レポートを送信できない場合はその他のエラー コードを返します。

解説

SetRawDeviceFeature メソッドは、機能レポートをデバイスに書き込みます。レポート ID はレポートの GameInputRawDeviceReportInfo から取得され、ペイロードは IGameInputRawDeviceReport::SetRawData で設定されたデータです。 デバイスが定義する機能レポートと、それぞれのサイズを調べるには、GetFeatureReportCount と GetFeatureReportInfo を使用します。現在、機能レポートは HID デバイスに対して公開されています。HID デバイスの場合、レポート データの最初のバイトはレポート ID です。 SetRawDeviceFeature は配信のためにレポートをキューに入れ、デバイスがレポートを処理するのを待たずに戻ります。成功の戻り値は、レポートが送信されたことを意味し、デバイスがレポートを受け入れたことを意味するものではありません。新しい状態を確認するには、GetRawDeviceFeature を呼び出してレポートを読み戻します。
GameInput API の中級および高度なユース ケースについては、「GameInput の高度なトピック」を参照してください。

要件

ヘッダー: GameInput.h ライブラリ: gameinput.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体、XBOX Series 本体

関連項目

GameInput の概要
GetRawDeviceFeature
GetFeatureReportCount
GetFeatureReportInfo
CreateRawDeviceReport
IGameInputRawDeviceReport
IGameInputDevice

バージョン履歴

付録: 以前のバージョン

v0

GameInput v0 では、このメソッドは同じシグネチャで宣言されていましたが、実装されていませんでした。詳細については、IGameInputDevice::SetRawDeviceFeature (非推奨) を参照してください。
最終更新日 2026年11月6日