HidP_InitializeReportForID 함수(hidpi.h)
HidP_InitializeReportForID 루틴은 HID 보고서를 초기화합니다.
구문
NTSTATUS HidP_InitializeReportForID(
[in] HIDP_REPORT_TYPE ReportType,
[in] UCHAR ReportID,
[in] PHIDP_PREPARSED_DATA PreparsedData,
[out] PCHAR Report,
[in] ULONG ReportLength
);
매개 변수
[in] ReportType
보고서에 있는 HID 보고서의 형식을 나타내는 HIDP_REPORT_TYPE 열거자를 지정합니다.
[in] ReportID
보고서 ID를 지정합니다.
[in] PreparsedData
보고서에 있는 HID 보고서와 연결된 최상위 컬렉션의 준비 데이터에 대한 포인터입니다.
[out] Report
HidP_InitializeReportForID 초기화하는 HID 보고서를 포함하는 호출자가 할당한 버퍼에 대한 포인터입니다.
[in] ReportLength
보고서에 있는 HID 보고서의 크기(바이트)를 지정합니다. ReportLength는 컬렉션의 HIDP_CAPS 구조체의 XxxReportByteLength 멤버에 지정된 대로 지정된 보고서 형식에 대한 컬렉션의 보고서 길이와 같아야 합니다.
반환 값
HidP_InitializeReportForID 다음 상태 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
보고서가 성공적으로 초기화되었습니다. |
|
준비한 데이터가 잘못되었습니다. |
|
보고서의 지정된 길이가 지정된 보고서 형식에 대한 컬렉션의 보고서 길이와 같지 않습니다. |
|
보고서 유형이 잘못되었습니다. |
|
지정한 보고서 ID가 잘못되었습니다. |
설명
HID 보고서를 초기화하면 USB HID 표준에 정의된 대로 모든 컨트롤 데이터가 0 또는 컨트롤의 null 값으로 설정됩니다. (null 값을 보내거나 받는 것은 컨트롤의 현재 값을 수정해서는 안 됨을 나타냅니다.)
HidP_InitializeReportForID 다음을 수행합니다.
- null 값이 없는 모든 단추 및 값의 비트 필드를 0으로 설정합니다.
- null 값이 있는 모든 컨트롤의 비트 필드를 해당 null 값으로 설정합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | hidpi.h(Hidpi.h 포함) |
| 라이브러리 | Hidparse.lib |
| IRQL | <= DISPATCH_LEVEL |