다음을 통해 공유

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

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

[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 지정된 값은 지정된 보고서에 포함되지 않지만 지정된 최상위 컬렉션에서 지원하는 다른 보고서에 포함되어 있습니다.

발언

크기 조정된 값은 민감도 및 디바이스 범위와 같은 특정 매개 변수에 따라 수정되는 원시 HID 데이터의 조정된 출력을 나타냅니다. 이렇게 조정하면 디바이스의 의도된 사용과 관련하여 데이터를 보다 의미 있게 해석할 수 있습니다.

HID 보고서를 해석하는 방법과 크기 조정된 값의 중요성에 대한 자세한 내용은 HID 보고서 해석참조하세요.

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

참고 항목