다음을 통해 공유

HidP_SetUsageValueArray 함수(hidpi.h)

  • 아티클

HidP_SetUsageValueArray 루틴은 지정된 HID 보고서에서 HID 컨트롤 사용량 값 배열을 설정합니다.

구문

NTSTATUS HidP_SetUsageValueArray(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [in]      USAGE                UsagePage,
  [in]      USHORT               LinkCollection,
  [in]      USAGE                Usage,
  [in]      PCHAR                UsageValue,
  [in]      USHORT               UsageValueByteLength,
  [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] UsageValueByteLength

UsageValue 버퍼의 길이(바이트)를 지정합니다.

[in] PreparsedData

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

[in, out] Report

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

[in] ReportLength

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

반환 값

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

반환 코드 설명
HIDP_STATUS_SUCCESS
 루틴이 사용량 값을 성공적으로 설정합니다.
HIDP_STATUS_INVALID_REPORT_LENGTH
 보고서 길이가 잘못되었습니다.
HIDP_STATUS_INVALID_REPORT_TYPE
 지정한 보고서 형식이 잘못되었습니다.
HIDP_STATUS_BUFFER_TOO_SMALL
 UsageValue 버퍼의 크기(바이트)가 너무 작습니다.
HIDP_STATUS_INCOMPATIBLE_REPORT_ID
 사용량은 지정된 보고서에 없지만 지정된 형식의 다른 보고서에 존재합니다.
HIDP_STATUS_NOT_VALUE_ARRAY
 지정된 사용량은 사용량 값 배열이 아닙니다.
HIDP_STATUS_INVALID_PREPARSED_DATA
 준비한 데이터가 잘못되었습니다.
HIDP_STATUS_REPORT_DOES_NOT_EXIST
 지정된 형식에 대한 보고서가 없습니다.
HIDP_STATUS_NOT_IMPLEMENTED
 사용량 값 배열에 지정된 데이터 필드의 보고서 크기는 8비트 중 배수가 아닙니다.
HIDP_STATUS_USAGE_NOT_FOUND
 지정된 보고서 유형의 보고서에는 사용량이 없습니다.

설명

UsageValue 버퍼의 필요한 크기(바이트)는 사용량 값 배열의 HIDP_VALUE_CAPS 구조에서 BitSize 및 ReportCount 멤버를 곱하고 결과를 가장 가까운 바이트로 반올림하여 결정됩니다.

HidP_SetUsageValueArray 배열의 각 데이터 필드가 8비트 중 배수인 사용량 값 배열만 지원합니다.

호출자는 보고서에서 발생해야 하는 대로 UsageValue 버퍼를 정확히 설정해야 합니다.

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

요구 사항

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

추가 정보

HidP_SetScaledUsageValue

HidP_SetUsageValue

_HIDP_PREPARSED_DATA