IOCTL_USB_GET_NODE_CONNECTION_INFORMATION IOCTL (usbioctl.h)

  • Artikel

Permintaan IOCTL_USB_GET_NODE_CONNECTION_INFORMATION mengambil informasi tentang port USB yang ditunjukkan dan perangkat yang terpasang pada port, jika ada.

Driver klien harus mengirim IOCTL ini di IRQL PASSIVE_LEVEL.

IOCTL_USB_GET_NODE_CONNECTION_INFORMATION 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

Anggota AssociatedIrp.SystemBuffer menunjuk ke struktur USB_NODE_CONNECTION_INFORMATION yang dialokasikan pengguna yang menjelaskan koneksi. Pada input, anggota ConnectionIndex dari struktur ini berisi nomor port.

Panjang buffer input

Ukuran struktur USB_NODE_CONNECTION_INFORMATION .

Buffer output

Pada output, anggota Parameters.DeviceIoControl.OutputBufferLength berisi ukuran data output. Ukuran ini bervariasi, karena tergantung pada jumlah pipa yang terkait dengan port.

AssociatedIrp.SystemBuffer menunjuk ke struktur USB_NODE_CONNECTION_INFORMATION yang dialokasikan pengguna yang berisi data output.

Panjang buffer output

Ukuran struktur USB_NODE_CONNECTION_INFORMATION .

Blok status

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

Keterangan

Permintaan IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX adalah versi IOCTL_USB_GET_NODE_CONNECTION_INFORMATION yang diperluas. Kedua permintaan tersebut identik, kecuali bahwa versi permintaan yang diperluas dapat melaporkan koneksi rendah, penuh, dan kecepatan tinggi dan permintaan IOCTL_USB_GET_NODE_CONNECTION_INFORMATION yang lebih lama hanya melaporkan koneksi berkecepatan rendah dan penuh. Untuk informasi selengkapnya tentang perbedaan antara kedua permintaan ini, lihat USB_NODE_CONNECTION_INFORMATION dan USB_NODE_CONNECTION_INFORMATION_EX.

Persyaratan

Persyaratan Nilai
Header usbioctl.h (termasuk Usbioctl.h)

Lihat juga

IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX

USB_NODE_CONNECTION_INFORMATION

USB_NODE_CONNECTION_INFORMATION_EX