HidP_GetExtendedAttributes 함수(hidpi.h)

HidP_GetExtendedAttributes 루틴은 HID 컨트롤의 확장 특성을 반환합니다.

구문

NTSTATUS HidP_GetExtendedAttributes(
  [in]      HIDP_REPORT_TYPE          ReportType,
  [in]      USHORT                    DataIndex,
  [in]      PHIDP_PREPARSED_DATA      PreparsedData,
  [out]     PHIDP_EXTENDED_ATTRIBUTES Attributes,
  [in, out] PULONG                    LengthAttributes
);

매개 변수

[in] ReportType

DataIndex에서 지정한 HID 컨트롤과 연결된 HID 보고서의 형식을 나타내는 HIDP_REPORT_TYPE 열거자 값을 지정합니다.

[in] DataIndex

HID 컨트롤의 데이터 인덱 스를 지정합니다.

[in] PreparsedData

지정된 컨트롤을 포함하는 최상위 컬렉션에 대해 준비한 데이터를 지정합니다.

[out] Attributes

루틴이 DataIndex에서 지정한 컨트롤의 확장 특성을 반환하는 데 사용하는 호출자 할당 버퍼에 대한 포인터입니다.

[in, out] LengthAttributes

특성 버퍼의 크기(바이트)를 지정합니다(sizeof(HIDP_EXTENDED_ATTRIBUTES)보다 크거나 같아야 합니다.

반환 값

HidP_GetExtendedAttributes 다음 상태 값 중 하나를 반환합니다.

반환 코드	설명
HIDP_STATUS_SUCCESS	루틴은 컨트롤의 확장된 특성 정보를 모두 반환했습니다.
HIDP_STATUS_BUFFER_TOO_SMALL	특성 버퍼가 확장된 모든 특성 정보를 보유할 만큼 크지 않았습니다.
HIDP_STATUS_DATA_INDEX_NOT_FOUND	지정된 데이터 인덱스가 잘못되었습니다.

설명

HidP_GetExtendedAttributes 특성 버퍼에서 가변 길이 HIDP_EXTENDED_ATTRIBUTES 구조를 반환합니다. 확장 특성 구조에는 고정 길이 멤버(NumGlobalUnknowns, Reserved 및 GlobalUnknowns)와 HIDP_UNKNOWN_TOKEN 구조체의 가변 길이 배열이 연속 순서로 포함됩니다. 알 수 없는 토큰 배열의 첫 번째 멤버는 (PHIDP_UNKNOWN_TOKEN*)&(Attributes-Data>)에 있습니다.

루틴은 특성 버퍼 가 보유할 수 있는 확장 특성 정보의 바이트를 반환합니다. 버퍼가 너무 작으면 루틴이 반환하는 정보를 자립니다. 변수 길이 배열에서 알 수 없는 토큰 수를 확인하기 위해 호출자는 먼저 특성 버퍼를 사용하여 확장 특성 정보의 NumGlobalUnknowns 멤버 값을 반환할 수 있습니다.

자세한 내용은 HID 컬렉션을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	hidpi.h(Hidpi.h 포함)
라이브러리	Hidparse.lib
IRQL	<= DISPATCH_ LEVEL

추가 정보

HIDP_EXTENDED_ATTRIBUTES

HIDP_UNKNOWN_TOKEN

_HIDP_PREPARSED_DATA