다음을 통해 공유

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

특성 버퍼의 크기(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*)&(특성->데이터)에 있습니다.

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

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

요구 사항

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

참고 항목

HIDP_EXTENDED_ATTRIBUTES

HIDP_UNKNOWN_TOKEN

_HIDP_PREPARSED_DATA