次の方法で共有

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_STATUS_SUCCESS
 ルーチンは、コントロールのすべての拡張属性情報を正常に返しました。
HIDP_STATUS_BUFFER_TOO_SMALL
 属性 バッファーが、すべての拡張属性情報を保持するのに十分な大きさではなかった。
HIDP_STATUS_DATA_INDEX_NOT_FOUND
 指定されたデータ インデックスが無効です。

備考

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

関連項目

HIDP_EXTENDED_ATTRIBUTES

HIDP_UNKNOWN_TOKEN

_HIDP_PREPARSED_DATA