通过

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