다음을 통해 공유


HidP_GetButtonCaps 함수(hidpi.h)

HidP_GetButtonCaps 루틴은 지정된 유형의 HID 보고서에 대한 최상위 컬렉션의 모든 HID 컨트롤 단추를 설명하는 단추 기능 배열을 반환합니다.

구문

NTSTATUS HidP_GetButtonCaps(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [out]     PHIDP_BUTTON_CAPS    ButtonCaps,
  [in, out] PUSHORT              ButtonCapsLength,
  [in]      PHIDP_PREPARSED_DATA PreparsedData
);

매개 변수

[in] ReportType

보고서 형식을 식별하는 HIDP_REPORT_TYPE 열거자 값을 지정합니다.

[out] ButtonCaps

루틴이 지정된 보고서 형식에 대한 단추 기능 배열을 반환하는 데 사용하는 호출자 할당 버퍼에 대한 포인터입니다.

[in, out] ButtonCapsLength

ButtonCaps에 제공된 버퍼의 입력 길이(배열 요소)를 지정합니다. 출력에서 이 매개 변수는 루틴이 반환하는 실제 요소 수로 설정됩니다.

[in] PreparsedData

최상위 컬렉션의 준비 데이터에 대한 포인터입니다.

반환 값

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

반환 코드 설명
HIDP_STATUS_SUCCESS
루틴이 기능 데이터를 성공적으로 반환했습니다.
HIDP_STATUS_INVALID_PREPARSED_DATA
준비한 데이터가 잘못되었습니다.

설명

HidP_GetButtonCaps 지정된 보고서 형식의 최상위 컬렉션에 있는 모든 단추의 기능을 반환합니다.

ButtonCapsLength는 HidP_GetCaps 반환된 HIDP_CAPS 구조체의 NumberXxxButtonCaps 멤버 값으로 설정해야 합니다. 여기서 Xxx는 보고서 형식을 지정합니다.

사용량, 사용량 페이지 또는 링크 컬렉션에서 선택한 단추 기능의 하위 집합을 가져오려면 HidP_GetSpecificButtonCaps 사용합니다.

컬렉션의 기능에 대한 자세한 내용은 컬렉션 정보 가져오기를 참조하세요.

HID 컬렉션도 참조하세요.

요구 사항

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

추가 정보

HIDP_BUTTON_CAPS

HidP_GetCaps

HidP_GetSpecificButtonCaps

_HIDP_PREPARSED_DATA