HidP_SetScaledUsageValue 함수(hidpi.h)

아티클
08/07/2023

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

보고서에 있는 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

보고서에 있는 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 값을 설정합니다.

설명

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

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

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

요구 사항

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