HidP_GetExtendedAttributes関数 (hidpi.h)
HidP_GetExtendedAttributes ルーチンは、HID コントロールの拡張属性を返します。
構文
NTSTATUS HidP_GetExtendedAttributes(
[in] HIDP_REPORT_TYPE ReportType,
[in] USHORT DataIndex,
[in] PHIDP_PREPARSED_DATA PreparsedData,
[out] PHIDP_EXTENDED_ATTRIBUTES Attributes,
[in, out] PULONG LengthAttributes
);
パラメーター
[in] ReportType
DataIndex で指定された HID コントロールに関連付けられている HID レポートの種類を示す HIDP_REPORT_TYPE 列挙子の値指定します。
[in] DataIndex
HID コントロールの データ インデックス を指定します。
[in] PreparsedData
指定したコントロールを含む 最上位のコレクション の 準備済みデータ を指定します。
[out] Attributes
dataIndex で指定されたコントロールの拡張属性を返すためにルーチンが使用する呼び出し元によって割り当てられたバッファーへのポインター。
[in, out] LengthAttributes
バッファー 属性のサイズをバイト単位で指定します (sizeof(HIDP_EXTENDED_ATTRIBUTES 以上である必要があります)。
戻り値
HidP_GetExtendedAttributes は、次のいずれかの状態値を返します。
リターン コード | 形容 |
---|---|
|
ルーチンは、コントロールのすべての拡張属性情報を正常に返しました。 |
|
属性 バッファーが、すべての拡張属性情報を保持するのに十分な大きさではなかった。 |
|
指定されたデータ インデックスが無効です。 |
備考
HidP_GetExtendedAttributes は、Attribute バッファー内の可変長 HIDP_EXTENDED_ATTRIBUTES 構造体を返します。 拡張属性構造体には、固定長メンバー (NumGlobalUnknowns、予約済み、および GlobalUnknowns) が連続して含まれており、その後に HIDP_UNKNOWN_TOKEN 構造体の可変長配列が続きます。 不明なトークン配列の最初のメンバーは、(PHIDP_UNKNOWN_TOKEN*)&(属性->Data) にあります。
このルーチンは、属性 バッファーが保持できる数の拡張属性情報のバイト数を返します。 バッファーが小さすぎると、ルーチンは返される情報を切り捨てます。 可変長配列内の不明なトークンの数を調べるために、呼び出し元は最初に Attributes バッファーを使用して、拡張属性情報の NumGlobalUnknowns メンバーの値を返すことができます。
詳細については、「HID コレクションの」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 2000 以降のバージョンの Windows で使用できます。 |
ターゲット プラットフォーム の | 万国 |
ヘッダー | hidpi.h (Hidpi.h を含む) |
ライブラリ | Hidparse.lib |
IRQL | <= DISPATCH_ LEVEL |