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