IOCTL_USB_GET_HUB_INFORMATION_EX IOCTL(usbioctl.h)

USB_HUB_INFORMATION_EX 구조에서 USB 허브에 대한 정보를 검색하기 위해 애플리케이션에서 IOCTL_USB_GET_HUB_INFORMATION_EX I/O 제어 요청을 보냅니다.

요청은 허브에서 가장 높은 포트 번호를 검색합니다. USB 2.0 및 SuperSpeed 허브(루트가 아닌 허브)의 경우 요청은 USB 2.0 및 3.0 사양에 정의된 대로 연결된 허브 설명자도 검색합니다.

IOCTL_USB_GET_HUB_INFORMATION_EX 사용자 모드 I/O 제어 요청입니다. 이 요청은 USB 허브 디바이스(GUID_DEVINTERFACE_USB_HUB)를 대상으로 합니다.

주 코드

IRP_MJ_DEVICE_CONTROL

입력 버퍼

AssociatedIrp.SystemBuffer는 호출자가 할당한 USB_HUB_INFORMATION_EX 구조를 가리킵니다.

입력 버퍼 길이

Parameters.DeviceIoControl.InputBufferLength 멤버는 크기가 와 같은 sizeof(USB_HUB_INFORMATION_EX)호출자 할당 버퍼의 크기를 바이트 단위로 나타냅니다.

출력 버퍼

출력에서 AssociatedIrp.SystemBuffer가 가리키는 USB_HUB_INFORMATION_EX 구조체는 허브에 대한 정보로 채워집니다.

출력 버퍼 길이

Parameters.DeviceIoControl.OutputBufferLength 멤버는 출력 버퍼 SystemBuffer의 크기를 바이트 단위로 나타냅니다.

상태 블록

USB 스택은 요청이 성공하면 Irp-IoStatus.Status>를 STATUS_SUCCESS 설정합니다. 그렇지 않으면 USB 드라이버 스택이 상태를 STATUS_INVALID_PARAMETER 또는 STATUS_INSUFFICIENT_RESOURCES 같은 적절한 오류 조건으로 설정합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8
지원되는 최소 서버	지원되는 버전 없음
머리글	usbioctl.h(Usbioctl.h 포함)

추가 정보

USB_HUB_INFORMATION_EX