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 다음 상태 값 중 하나를 반환합니다.

설명

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

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

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

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

요구 사항

추가 정보

HidP_SetScaledUsageValue

HidP_SetUsageValue

_HIDP_PREPARSED_DATA