다음을 통해 공유


HidP_GetScaledUsageValue 함수(hidpi.h)

HidP_GetScaledUsageValue 루틴은 HID 보고서에서 추출된 HID 컨트롤 값의 서명되고 크기가 조정된 결과를 반환합니다.

구문

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

매개 변수

[in] ReportType

HID 사용량 값을 포함하는 HID 보고서의 형식을 식별하는 HIDP_REPORT_TYPE 열거자 값을 지정합니다.

[in] UsagePage

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

[in] LinkCollection

추출할 값의 링크 컬렉션 식별자를 지정합니다. LinkCollection 값이 0이면 최상위 컬렉션이 식별됩니다.

[in] Usage

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

[out] UsageValue

루틴이 서명되고 크기 조정된 값을 반환하는 버퍼에 대한 포인터입니다.

[in] PreparsedData

보고서에 있는 보고서를 생성한 최상위 컬렉션준비 데이터에 대한 포인터입니다.

[in] Report

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

[in] ReportLength

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

반환 값

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

반환 코드 설명
HIDP_STATUS_SUCCESS
루틴이 값을 성공적으로 반환했습니다.
HIDP_STATUS_INVALID_REPORT_TYPE
지정한 보고서 형식이 잘못되었습니다.
HIDP_STATUS_INVALID_REPORT_LENGTH
지정한 보고서 길이가 잘못되었습니다.
HIDP_STATUS_BAD_LOG_PHY_VALUES
컬렉션이 잘못된 논리적 또는 물리적 값을 반환했습니다. 컬렉션에서 반환된 값을 추출하려면 HidP_GetUsageValue 호출합니다.
HIDP_STATUS_NULL
컬렉션에서 크기 조정된 값의 현재 상태가 논리적 최소값보다 작거나 논리 최댓값보다 크며 크기 조정된 값은 NULL 상태입니다.
HIDP_STATUS_VALUE_OUT_OF_RANGE
컬렉션에서 크기가 조정된 값 데이터의 현재 상태가 논리적 최소값보다 작거나 논리 최댓값보다 큽니다.
HIDP_STATUS_USAGE_NOT_FOUND
지정된 사용량, 사용량 페이지 또는 링크 컬렉션은 지정된 최상위 컬렉션에서 지원하는 보고서에서 찾을 수 없습니다.
HIDP_STATUS_INCOMPATIBLE_REPORT_ID
지정된 값은 지정된 보고서에 포함되지 않지만 지정된 최상위 컬렉션에서 지원하는 다른 보고서에 포함되어 있습니다.

설명

PreparsedData, UsageValue Report에 제공된 호출자 할당 버퍼는 페이지가 없는 풀에서 할당되어야 합니다.

사용자 모드 애플리케이션 및 커널 모드 드라이버는 HidP_GetUsageValueArray 사용하여 사용량 값 배열에 대한 데이터를 추출해야 합니다.

루틴이 상태 HIDP_STATUS_BAD_LOG_PHY_VALUES 반환하는 경우 애플리케이션 또는 드라이버는 HidP_GetUsageValue 호출하여 원시 사용량 현황 데이터를 추출할 수 있습니다.

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

요구 사항

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

추가 정보

HidP_GetUsageValue

HidP_GetUsageValueArray

_HIDP_PREPARSED_DATA