HidD_GetFeature関数 (hidsdi.h)

HidD_GetFeature ルーチンは、指定した最上位コレクションから特徴レポートを返します。

構文

BOOLEAN HidD_GetFeature(
  [in]  HANDLE HidDeviceObject,
  [out] PVOID  ReportBuffer,
  [in]  ULONG  ReportBufferLength
);

[in] HidDeviceObject

最上位のコレクションに対する開いているハンドル。

[out] ReportBuffer

呼び出し元がレポート ID を指定するために使用する、呼び出し元によって割り当てられた HID レポートバッファーへのポインター。 HidD_GetFeature は 、ReportBuffer を使用して、指定した機能レポートを返します。

このパラメーターの詳細については、「解説」セクションを参照してください。

[in] ReportBufferLength

レポートバッファーのサイズ (バイト単位)。レポートバッファーは、機能レポートを保持するのに十分な大きさに加えて、0 以外のレポート ID を指定する 1 つの追加バイトが必要です。レポート ID を使用しない場合、ID 値は 0 です。

HidD_GetFeature成功した場合は TRUE を返します。それ以外の場合は、FALSE を返します。 GetLastError を使用して、拡張エラー情報を取得します。

正しい ReportBufferLength は、呼び出しから返される最上位コレクションのHIDP_CAPS構造体の FeatureReportByteLength メンバー HidP_GetCaps指定されます。

HidD_GetFeature ルーチンを呼び出す前に、呼び出し元は次の操作を行う必要があります。

最上位のコレクションにレポート ID が含まれている場合、呼び出し元は ReportBuffer パラメーターの最初のバイトを 0 以外のレポート ID に設定する必要があります。
最上位のコレクションにレポート ID が含まれていない場合、呼び出し元は ReportBuffer パラメーターの最初のバイトを 0 に設定する必要があります。

機能レポートは ReportBuffer パラメーターで返されます。レポート ID に応じて、呼び出し元は次のいずれかの関数を呼び出してレポートを解析します。

HID レポートを解析する方法の例については、 HClient サンプルアプリケーションを参照してください。このサンプルは、MSDN コードギャラリーにあります。

HidD_GetFeatureを呼び出すことができるのは、ユーザーモードアプリケーションだけです。カーネルモードドライバーは、 IOCTL_HID_GET_FEATURE 要求を使用できます。

要件	値
サポートされている最小のクライアント	Windows 2000 以降のバージョンの Windows で使用できます。
対象プラットフォーム	ユニバーサル
Header	hidsdi.h (Hidsdi.h を含む)
Library	Hid.lib
[DLL]	Hid.dll