IOCTL_USB_GET_HUB_INFORMATION_EX IOCTL (usbioctl.h)

  • Artikel

Permintaan kontrol I/O IOCTL_USB_GET_HUB_INFORMATION_EX dikirim oleh aplikasi untuk mengambil informasi tentang hub USB dalam struktur USB_HUB_INFORMATION_EX .

Permintaan mengambil nomor port tertinggi di hub. Untuk hub USB 2.0 dan SuperSpeed (hub non-root), permintaan juga mengambil deskriptor hub terkait, sebagaimana didefinisikan dalam Spesifikasi USB 2.0 dan 3.0, masing-masing.

IOCTL_USB_GET_HUB_INFORMATION_EX adalah permintaan kontrol I/O mode pengguna. Permintaan ini menargetkan perangkat hub USB (GUID_DEVINTERFACE_USB_HUB).

Kode utama

IRP_MJ_DEVICE_CONTROL

Buffer input

AssociatedIrp.SystemBuffer menunjuk ke struktur USB_HUB_INFORMATION_EX yang dialokasikan pemanggil.

Panjang buffer input

Anggota Parameters.DeviceIoControl.InputBufferLength menunjukkan ukuran, dalam byte, dari buffer yang dialokasikan pemanggil yang ukurannya sama dengan sizeof(USB_HUB_INFORMATION_EX).

Buffer output

Pada output, struktur USB_HUB_INFORMATION_EX yang diacu oleh AssociatedIrp.SystemBuffer diisi dengan informasi tentang hub.

Panjang buffer output

Anggota Parameters.DeviceIoControl.OutputBufferLength menunjukkan ukuran, dalam byte, dari buffer output SystemBuffer.

Blok status

Tumpukan USB mengatur Irp-IoStatus.Status> ke STATUS_SUCCESS jika permintaan berhasil. Jika tidak, tumpukan driver USB mengatur Status ke kondisi kesalahan yang sesuai, seperti STATUS_INVALID_PARAMETER atau STATUS_INSUFFICIENT_RESOURCES.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8
Server minimum yang didukung Tidak ada yang didukung
Header usbioctl.h (termasuk Usbioctl.h)

Lihat juga

USB_HUB_INFORMATION_EX