HidP_SetUsageValue 함수(hidpi.h)

  • 아티클

HidP_SetUsageValue 루틴은 지정된 HID 보고서에서 HID 컨트롤 값을 설정합니다.

구문

NTSTATUS HidP_SetUsageValue(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [in]      USAGE                UsagePage,
  [in]      USHORT               LinkCollection,
  [in]      USAGE                Usage,
  [in]      ULONG                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_SetUsageValue 다음 상태 값 중 하나를 반환합니다.

반환 코드 설명
HIDP_STATUS_SUCCESS
 루틴이 사용량 값을 성공적으로 설정합니다.
HIDP_STATUS_INCOMPATIBLE_REPORT_ID
 사용량은 지정된 보고서에 없지만 지정된 형식의 다른 보고서에 존재합니다.
HIDP_STATUS_INVALID_PREPARSED_DATA
 준비한 데이터가 잘못되었습니다.
HIDP_STATUS_REPORT_DOES_NOT_EXIST
 지정된 형식에 대한 보고서가 없습니다.
HIDP_STATUS_USAGE_NOT_FOUND
 지정된 보고서 유형의 보고서에는 사용량이 없습니다.
HIDP_STATUS_INVALID_REPORT_LENGTH
 보고서 길이가 잘못되었습니다.
HIDP_STATUS_INVALID_REPORT_TYPE
 지정한 보고서 형식이 잘못되었습니다.

설명

HidP_SetUsageValue 루틴은 값에 서명하지 않습니다. 사용자 모드 애플리케이션 또는 커널 모드 드라이버는 이 값의 HIDP_VALUE_CAPS 구조에 제공된 위치에서 값에 서명하거나 HidP_SetScaledUsageValue 호출해야 합니다.

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

요구 사항

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

추가 정보

HIDP_VALUE_CAPS

HidP_SetScaledUsageValue

_HIDP_PREPARSED_DATA