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.SystemBuffer는USB_HUB_NAME 구조를 가리킵니다.
입력 버퍼 길이
Parameters.DeviceIoControl.OutputBufferLength는 Irp-AssociatedIrp.SystemBuffer> 필드에 전달된 버퍼의 길이(바이트)입니다.
출력 버퍼
Irp->ASSOCIATedIrp.SystemBuffer 는 루트 허브의 기호 이름으로 채워집니다.
출력 버퍼 길이
루트 허브의 기호 이름 길이입니다.
상태 블록
하위 수준 드라이버는 Irp-IoStatus.Status>를 STATUS_SUCCESS 설정하거나 적절한 오류 상태. Irp-IoStatus.Information>를 USB_ROOT_HUB_NAME 구조체를 보유하는 데 필요한 바이트 수로 설정합니다. 요청이 실패하면 드라이버는 이 정보를 사용하여 충분한 버퍼로 요청을 다시 제출할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 | usbioctl.h(Usbioctl.h 포함) |