다음을 통해 공유

HidP_SetScaledUsageValue 함수(hidpi.h)

  • 아티클

HidP_SetScaledUsageValue 루틴은 부호 있고 크기가 조정된 실제 숫자를 HID 사용량의 논리 값으로 변환하고 지정된 HID 보고서의 사용량 값을 설정합니다.

통사론

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

매개 변수

[in] ReportType

Report있는 HID 보고서의 형식을 나타내는 HIDP_REPORT_TYPE 열거자 값을 지정합니다.

[in] UsagePage

사용량의 사용 페이지 지정합니다.

[in] LinkCollection

사용량이 포함된 링크 컬렉션 지정합니다. LinkCollection 0이 아닌 경우 루틴은 이 링크 컬렉션에 있는 경우에만 사용량을 설정합니다. LinkCollection 0이면 루틴은 PreparsedData연결된 최상위 컬렉션 첫 번째 사용량을 설정합니다.

[in] Usage

사용량을 지정합니다.

[in] UsageValue

루틴이 사용량의 논리 값으로 변환되는 부호 있는 크기 조정된 실제 번호를 지정합니다.

[in] PreparsedData

최상위 수준의 준비 데이터대한 포인터입니다.

[in, out] Report

HID 보고서에 대한 포인터입니다.

[in] ReportLength

Report있는 HID 보고서의 크기(바이트)를 지정합니다. 이 크기는 컬렉션의 HIDP_CAPS 구조에서 반환할 HidP_GetCaps 지정된 보고서 형식의 보고서 길이와 같아야 합니다.

반환 값

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

반환 코드 묘사
HIDP_STATUS_SUCCESS 루틴이 사용 값을 성공적으로 설정합니다.
HIDP_STATUS_BAD_LOG_PHY_VALUES 사용량에는 크기 조정을 방지하는 잘못된 논리 또는 물리적 범위가 있습니다.
HIDP_STATUS_VALUE_OUT_OF_RANGE 지정된 물리적 값이 범위를 벗어났으며 사용량에 null 값이 없습니다.
HIDP_STATUS_INVALID_REPORT_LENGTH 보고서 길이가 잘못되었습니다.
HIDP_STATUS_INVALID_REPORT_TYPE 지정한 보고서 형식이 잘못되었습니다.
HIDP_STATUS_INCOMPATIBLE_REPORT_ID 지정한 보고서에는 사용량이 없지만 지정된 형식의 다른 보고서에는 해당 사용량이 없습니다.
HIDP_STATUS_INVALID_PREPARSED_DATA 준비한 데이터가 잘못되었습니다.
HIDP_STATUS_USAGE_NOT_FOUND 지정한 보고서 형식의 보고서에는 사용량이 없습니다.
HIDP_STATUS_NULL 지정된 물리적 값이 범위를 벗어났고, 사용량에 null 값이 있고, 루틴이 null 값을 설정합니다.

발언

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

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

HidP_SetScaledUsageValue 부호 비트를 설정합니다.

루틴이 HIDP_STATUS_INCOMPATIBLE_REPORT_ID 반환하는 경우 지정된 보고서에 사용량이 포함됩니다. 그러나 사용자 모드 애플리케이션 또는 커널 모드 드라이버는 초기화되지 않은 보고서에서 사용량을 설정할 수 있습니다. HID 보고서초기화하는 참조하세요.

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

요구 사항

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

참고 항목