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)를 대상으로 합니다.
주 코드
입력 버퍼
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 포함) |