IOCTL_HID_GET_COLLECTION_INFORMATION IOCTL(hidclass.h)

IOCTL_HID_GET_COLLECTION_INFORMATION 요청은 최상위 컬렉션의HID_COLLECTION_INFORMATION 구조를 가져옵니다. 이 정보에는 컬렉션에서 준비한 데이터의 크기(바이트)가 포함됩니다.

HIDClass 디바이스에 대한 일반적인 내용은 HID 컬렉션을 참조하세요.

주 코드

IRP_MJ_DEVICE_CONTROL

입력 버퍼

IRP의 I/O 스택 위치에 있는 Parameters.DeviceIoControl.OutputBufferLength는 출력 버퍼의 크기(바이트)를 나타내며, 이는 = sizeof(HID_COLLECTION_INFORMATION)여야 >합니다.

입력 버퍼 길이

sizeof(HID_COLLECTION_INFORMATION)보다 크거나 같습니다.

출력 버퍼

Irp->ASSOCIATedIrp.SystemBuffer 는 컬렉션 정보를 받을 버퍼를 가리킵니다. 이 데이터는 요청자가 제공한 버퍼에서 HID_COLLECTION_INFORMATION 구조로 형식이 지정됩니다.

출력 버퍼 길이

HID_COLLECTION_INFORMATION 구조체의 크기입니다.

상태 블록

HID 클래스 드라이버는 Irp-IoStatus>의 다음 필드를 설정합니다.

• 데이터가 성공적으로 검색되면 정보가 sizeof(HID_COLLECTION_INFORMATION)로 설정됩니다.
• 전송이 오류 없이 완료되면 상태가 STATUS_SUCCESS 설정됩니다. 그렇지 않으면 적절한 NTSTATUS 오류 코드로 설정됩니다.

요구 사항

요구 사항	값
헤더	hidclass.h(Hidclass.h 포함)

추가 정보

HID_COLLECTION_INFORMATION