IOCTL_USB_GET_ROOT_HUB_NAME IOCTL (usbioctl.h)

Permintaan kontrol I/O IOCTL_USB_GET_ROOT_HUB_NAME digunakan dengan struktur USB_ROOT_HUB_NAME untuk mengambil nama tautan simbolis hub akar.

IOCTL_USB_GET_ROOT_HUB_NAME adalah permintaan kontrol I/O mode pengguna. Permintaan ini menargetkan pengontrol host USB (GUID_DEVINTERFACE_USB_HOST_CONTROLLER).

Kode utama

IRP_MJ_DEVICE_CONTROL

Buffer input

Tidak ada.

Panjang buffer input

Tidak ada.

Buffer output

Pada output, anggota AssociatedIrp.SystemBuffer menunjuk ke struktur USB_ROOT_HUB_NAME yang berisi nama tautan simbolis hub akar. Teks "\xxx\ " terkemuka tidak disertakan dalam string yang diambil.

Panjang buffer output

Ukuran struktur USB_ROOT_HUB_NAME .

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.

Jika hub akar dihapus atau dihentikan, permintaan mengembalikan STATUS_SUCCESS tetapi stringnya ADALAH NULL.

Persyaratan

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

Lihat juga

USB_ROOT_HUB_NAME