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
Report있는 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 버퍼의 크기(바이트)가 너무 작습니다. |
|
지정한 보고서에는 사용량이 없지만 지정된 형식의 다른 보고서에는 해당 사용량이 없습니다. |
|
지정된 사용량이 사용량 값 배열이 아닙니다. |
|
준비한 데이터가 잘못되었습니다. |
|
지정된 형식에 대한 보고서가 없습니다. |
|
사용량 값 배열에 지정된 데이터 필드의 보고서 크기는 8비트 중 배수가 아닙니다. |
|
지정한 보고서 형식의 보고서에는 사용량이 없습니다. |
발언
UsageValue 버퍼의 필요한 크기(바이트)는 BitSize 및 ReportCount 사용량 값 배열의 HIDP_VALUE_CAPS 구조의 멤버를 곱하고 결과를 가장 가까운 바이트로 반올림하여 결정됩니다.
HidP_SetUsageValueArray 배열의 각 데이터 필드가 8비트 배수인 사용량 값 배열만 지원합니다.
호출자는 UsageValue 버퍼를 보고서에서 정확히 설정해야 합니다.
자세한 내용은 HID 컬렉션참조하세요.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다. |
| 대상 플랫폼 | 보편적 |
| 헤더 | hidpi.h(Hidpi.h 포함) |
| 라이브러리 | Hidparse.lib |
| IRQL | <= DISPATCH_LEVEL |