共用方式為

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_LINK_COLLECTION_NODE結構的陣列指標，其中 HidP_GetLinkCollectionNodes 會傳回最上層集合的連結集合陣列。

[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