HidP_GetSpecificValueCaps関数 (hidpi.h)
HidP_GetSpecificValueCaps ルーチンは、指定した選択条件を満たすすべての HID コントロール値を記述する 値機能配列 を返します。
構文
NTSTATUS HidP_GetSpecificValueCaps(
[in] HIDP_REPORT_TYPE ReportType,
[in] USAGE UsagePage,
[in] USHORT LinkCollection,
[in] USAGE Usage,
[out] PHIDP_VALUE_CAPS ValueCaps,
[in, out] PUSHORT ValueCapsLength,
[in] PHIDP_PREPARSED_DATA PreparsedData
);
パラメーター
[in] ReportType
レポートの種類を識別する HIDP_REPORT_TYPE 列挙子の値を指定します。
[in] UsagePage
検索条件として使用状況ページを指定します。 UsagePage が 0 以外の場合は、この使用ページを指定する値のみが返されます。
[in] LinkCollection
検索条件として リンク コレクション を指定します。 LinkCollection が 0 以外の場合は、このリンク コレクションの一部である値のみが返されます。
[in] Usage
検索条件として HID 使用法 を指定します。 Usage が 0 以外の場合は、この使用法を指定した値のみが返されます。
[out] ValueCaps
指定したレポートの種類の値機能配列をルーチンが返す呼び出し元によって割り当てられたバッファーへのポインター。
[in, out] ValueCapsLength
ValueCaps で提供されるバッファーの入力の長さを配列要素で指定します。 出力時に、このパラメーターは、ルーチンが実際に返す要素の数に設定されます。
[in] PreparsedData
最上位のコレクションの準備済みデータへのポインター。
戻り値
HidP_GetSpecificValueCaps は、次のいずれかの状態値を返します。
| リターン コード | NT 状態値 | 形容 |
|---|---|---|
|
|
このルーチンは、機能データを正常に返しました。 |
|
|
準備されたデータが無効です。 |
|
|
使用状況は、指定したレポートの種類のレポートには存在しません。 |
備考
ValueCaps バッファーの必要なサイズは、最上位のコレクションの HIDP_CAPS 構造体のメンバー XxxValueCaps 番号で指定されます。
HidP_GetSpecificValueCapsを呼び出すときは、UsagePage、Usage、LinkCollection に 0 を指定することは、HidP_GetValueCapsの呼び出しと同じです。
コレクションの機能の詳細については、「コレクション情報の取得 を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 以降のバージョンの Windows で使用できます。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | hidpi.h (Hidpi.h を含む) |
| ライブラリ | Hidparse.lib |
| IRQL | PASSIVE_LEVEL |