HidP_GetUsageValue 함수(hidpi.h)

아티클
02/29/2024

HidP_GetUsageValue 루틴은 HID 보고서의 선택 조건과 일치하는 HID 컨트롤 값과 연결된 데이터를 추출합니다.

구문

NTSTATUS HidP_GetUsageValue(
  [in]  HIDP_REPORT_TYPE     ReportType,
  [in]  USAGE                UsagePage,
  [in]  USHORT               LinkCollection,
  [in]  USAGE                Usage,
  [out] PULONG               UsageValue,
  [in]  PHIDP_PREPARSED_DATA PreparsedData,
  [in]  PCHAR                Report,
  [in]  ULONG                ReportLength
);

매개 변수

[in] ReportType

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

[in] UsagePage

값의 사용 페이지를 지정합니다.

[in] LinkCollection

값을 포함하는 링크 컬렉션을 지정합니다. LinkCollection이 0이 아닌 경우 루틴은 이 링크 컬렉션의 사용량만 검색합니다. 그렇지 않으면 LinkCollection이 0이면 루틴은 PreparsedData와 연결된 최상위 컬렉션에서 사용량을 검색합니다.

[in] Usage

값의 사용량을 지정합니다.

[out] UsageValue

루틴이 값 데이터를 반환하는 버퍼에 대한 포인터입니다.

[in] PreparsedData

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

[in] Report

값이 포함된 보고서에 대한 포인터입니다.

[in] ReportLength

보고서에 있는 보고서의 길이(바이트)를 지정합니다.

반환 값

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

반환 코드	설명
HIDP_STATUS_SUCCESS	루틴이 값 데이터를 성공적으로 반환했습니다.
HIDP_INVALID_REPORT_LENGTH	보고서 길이가 잘못되었습니다.
HIDP_INVALID_REPORT_TYPE	지정한 보고서 형식이 잘못되었습니다.
HIDP_STATUS_INCOMPATIBLE_REPORT_ID	컬렉션에는 지정된 형식의 보고서에 지정된 사용량 페이지의 값이 포함되어 있지만 지정된 보고서에는 이러한 사용법이 없습니다.
HIDP_STATUS_INVALID_PREPARSED_DATA	준비한 데이터가 잘못되었습니다.
HIDP_STATUS_USAGE_NOT_FOUND	컬렉션에는 지정된 보고서 유형의 보고서에 지정된 사용량 페이지의 값이 포함되어 있지 않습니다.

설명

HidP_GetUsageValue 값에 서명하거나 크기를 조정하지 않습니다. 서명된 값을 추출하려면 HidP_GetScaledUsageValue 사용합니다. 부호 비트를 수동으로 할당하기 위해 부호 비트의 위치는 값의 HIDP_VALUE_CAPS 구조체의 정보에서 확인할 수 있습니다.

HidP_GetUsageValue 보고서 수가 1인 사용량에 대한 사용량 값을 추출하도록 설계되었습니다. 지정된 사용량에 보고서 수가 1보다 큰 경우 사용량은 사용량 값 배열의 일부입니다. HidP_GetUsageValue 사용량 값 배열의 첫 번째 데이터 항목만 반환합니다. 사용량 값 배열의 모든 데이터 항목을 추출하려면 HidP_GetUsageValueArray 사용합니다.

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

요구 사항

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