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 포함)

추가 정보

USB_ROOT_HUB_NAME