IOCTL_INTERNAL_USB_GET_HUB_NAME IOCTL(usbioctl.h)
IOCTL_INTERNAL_USB_GET_HUB_NAME I/O 요청은 PDO가 허브에 대한 경우 드라이버에서 대상 PDO의 UNICODE 기호 이름을 검색하는 데 사용됩니다. 그렇지 않으면 NULL 문자열이 반환됩니다.
드라이버는 기호화된 이름을 사용하여 사용자 모드 I/O 컨트롤 요청 및 WMI 호출을 통해 허브에 대한 추가 정보를 검색할 수 있습니다.
IOCTL_INTERNAL_USB_GET_HUB_NAME 커널 모드 I/O 제어 요청입니다. 이 요청은 USB 허브 PDO를 대상으로 합니다. 이 요청은 PASSIVE_LEVEL IRQL에서 보내야 합니다.
주 코드
IRP_MJ_INTERNAL_DEVICE_CONTROL
입력 버퍼
Irp->AssociatedIrp.SystemBufferUSB_HUB_NAME 구조를 가리킵니다.
입력 버퍼 길이
Parameters.DeviceIoControl.OutputBufferLengthIrp->AssociatedIrp.SystemBuffer 필드에 전달된 버퍼의 길이(바이트)입니다.
출력 버퍼
Irp->AssociatedIrp.SystemBuffer 루트 허브의 기호 이름으로 채워집니다.
출력 버퍼 길이
루트 허브의 기호화된 이름의 길이입니다.
상태 블록
하위 수준 드라이버는 Irp->IoStatus.Status STATUS_SUCCESS 또는 적절한 오류 상태로 설정합니다. Irp->IoStatus.Information USB_ROOT_HUB_NAME 구조를 유지하는 데 필요한 바이트 수로 설정합니다. 요청이 실패하면 드라이버는 이 정보를 사용하여 충분한 버퍼로 요청을 다시 제출할 수 있습니다.
요구 사항
| 요구 | 값 |
|---|---|
| 헤더 | usbioctl.h(Usbioctl.h 포함) |