IOCTL_HID_GET_SERIALNUMBER_STRING IOCTL(hidclass.h)
IOCTL_HID_GET_SERIALNUMBER_STRING 요청은 디바이스의 일련 번호를 식별하는 최상위 컬렉션의 포함된 문자열을 가져옵니다. 검색된 문자열은 사람이 읽을 수 있는 형식의 NULL로 끝나는 와이드 문자열입니다.
HIDClass 디바이스에 대한 일반적인 내용은 HID 컬렉션을 참조하세요.
주 코드
입력 버퍼
IRP의 I/O 스택 위치에 있는 Parameters.DeviceIoControl.OutputBufferLength는 출력 버퍼의 크기(바이트)를 나타냅니다. 출력 버퍼가 NULL로 종료된 전체 포함된 문자열을 보유할 만큼 크지 않은 경우 요청은 출력 버퍼에 아무 것도 반환하지 않습니다.
입력 버퍼 길이
포함된 문자열에서 가능한 최대 문자 수는 디바이스별로 다릅니다. USB 디바이스의 경우 최대 문자열 길이는 126자입니다(종결 NULL 문자는 포함하지 않음).
출력 버퍼
Irp->MdlAddress 는 버퍼를 가리키며 일련 번호 문자열(NULL로 끝나는 와이드 문자열)을 받습니다.
출력 버퍼 길이
NULL로 끝나는 와이드 문자열의 길이입니다. 제공된 버퍼는 = 4093바이트(2^12 – 3)여야 합니다 <.
상태 블록
HID 클래스 드라이버는 Irp-IoStatus>의 다음 필드를 설정합니다.
정보는 디바이스에서 전송되는 바이트 수로 설정됩니다.
전송이 오류 없이 완료되면 상태가 STATUS_SUCCESS 설정됩니다. 그렇지 않으면 적절한 NTSTATUS 오류 코드로 설정됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 | hidclass.h(Hidclass.h 포함) |