次の方法で共有

HidP_GetLinkCollectionNodes関数 (hidpi.h)

  • [アーティクル]

HidP_GetLinkCollectionNodes ルーチンは、最上位 コレクションのリンク コレクション配列を返します。

構文

NTSTATUS HidP_GetLinkCollectionNodes(
  [out]     PHIDP_LINK_COLLECTION_NODE LinkCollectionNodes,
  [in, out] PULONG                     LinkCollectionNodesLength,
  [in]      PHIDP_PREPARSED_DATA       PreparsedData
);

パラメーター

[out] LinkCollectionNodes

HidP_GetLinkCollectionNodes が最上位レベルのコレクションのリンク コレクション配列を返すHIDP_LINK_COLLECTION_NODE構造体の呼び出し元によって割り当てられた配列へのポインター。

[in, out] LinkCollectionNodesLength

入力時に、LinkCollectionNodes バッファーの長さを配列要素で指定します。 出力時に、このルーチン LinkCollectionNodesLength を、設定した配列内のエントリの数に設定します。

[in] PreparsedData

このルーチンがリンク コレクション配列を返す最上位レベルのコレクションの準備済みデータへのポインター。

戻り値

HidP_GetLinkCollectionNodes は、次のいずれかの状態コードを返します。

リターン コード 形容
HIDP_STATUS_SUCCESS
 ルーチンは、指定されたコレクションのリンク コレクション配列を正常に返しました。
HIDP_STATUS_INVALID_PREPARSED_DATA
 準備されたデータが無効です。
HIDP_STATUS_BUFFER_TOO_SMALL
LinkCollectionNodes バッファーが小さすぎて、リンク コレクション配列全体を保持できません。

備考

LinkCollectionNodes バッファーの必要な長さは、コレクションの HIDP_CAPS 構造体のメンバー NumberLinkCollectionNodes によって指定されます。

HidP_GetLinkCollectionNodes HIDP_STATUS_BUFFER_TOO_SMALL状態値を返す場合は、LinkCollectionNodesLength 、リンク コレクション ノードの情報を保持するために必要な長さ (配列要素) にも設定されます。

詳細については、「HID コレクションの」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 以降のバージョンの Windows で使用できます。
ターゲット プラットフォーム の 万国
ヘッダー hidpi.h (Hidpi.h を含む)
ライブラリ Hidparse.lib
IRQL <= DISPATCH_LEVEL

関連項目

HIDP_CAPS

HIDP_LINK_COLLECTION_NODE

HidP_GetCaps

_HIDP_PREPARSED_DATA