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 會傳回下列其中一個狀態代碼：

傳回碼 Description
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。
目標平台 Universal
標頭 hidpi.h (包含 Hidpi.h)
程式庫 Hidparse.lib
IRQL <= DISPATCH_LEVEL

另請參閱

HIDP_CAPS

HIDP_LINK_COLLECTION_NODE

HidP_GetCaps

_HIDP_PREPARSED_DATA