IOCTL_USB_GET_NODE_CONNECTION_NAME IOCTL (usbioctl.h)

  • Artikel

Permintaan kontrol I/O IOCTL_USB_GET_NODE_CONNECTION_NAME digunakan dengan struktur USB_NODE_CONNECTION_NAME untuk mengambil nama tautan simbolis hub yang dilampirkan ke port hilir.

IOCTL_USB_GET_NODE_CONNECTION_NAME 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_NAME . Pada input, anggota ConnectionIndex dari struktur ini harus menunjukkan jumlah port untuk memeriksa hub terlampir.

Panjang buffer input

Ukuran struktur USB_NODE_CONNECTION_NAME .

Buffer output

AssociatedIrp.SystemBuffer menunjuk ke struktur USB_NODE_CONNECTION_NAME . Pada output, struktur ini berisi nama simbolis hub terlampir di anggota HubName . Jika tidak ada hub yang terpasang, hub tidak memiliki tautan simbolis, atau perangkat yang terpasang bukan hub, HubName[0] akan berisi nilai UNICODE_NULL.

Panjang buffer output

Anggota Parameters.DeviceIoControl.OutputBufferLength berisi ukuran, dalam byte, dari seluruh struktur USB_NODE_CONNECTION_NAME .

Blok status

Tumpukan USB mengatur Irp-IoStatus.Status> ke STATUS_SUCCESS jika permintaan berhasil. Permintaan melaporkan keberhasilan, bahkan jika tidak ada hub yang terpasang, hub yang terpasang tidak memiliki tautan simbolis, atau perangkat yang terpasang bukan hub.

Jika tidak, tumpukan USB mengatur Status ke kondisi kesalahan yang sesuai, seperti STATUS_INVALID_PARAMETER atau STATUS_INSUFFICIENT_RESOURCES.

Persyaratan

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

Lihat juga

USB_NODE_CONNECTION_NAME