IOCTL_INTERNAL_USB_GET_HUB_NAME IOCTL (usbioctl.h)

Permintaan I/O IOCTL_INTERNAL_USB_GET_HUB_NAME digunakan oleh driver untuk mengambil nama simbolis UNICODE untuk PDO target jika PDO adalah untuk hub. Jika tidak, string NULL dikembalikan.

Driver dapat menggunakan nama simbolis untuk mengambil informasi tambahan tentang hub melalui permintaan kontrol I/O mode pengguna dan panggilan WMI.

IOCTL_INTERNAL_USB_GET_HUB_NAME adalah permintaan kontrol I/O mode kernel. Permintaan ini menargetkan PDO hub USB. Permintaan ini harus dikirim di IRQL PASSIVE_LEVEL.

Kode utama

IRP_MJ_INTERNAL_DEVICE_CONTROL

Buffer input

Irp->AssociatedIrp.SystemBuffer menunjuk ke struktur USB_HUB_NAME .

Panjang buffer input

Parameters.DeviceIoControl.OutputBufferLength adalah panjang buffer (dalam byte) yang diteruskan di bidang Irp-AssociatedIrp.SystemBuffer>.

Buffer output

Irp->AssociatedIrp.SystemBuffer diisi dengan nama simbolis hub akar.

Panjang buffer output

Panjang nama simbolis hub akar.

Blok status

Driver tingkat bawah mengatur Irp-IoStatus.Status> ke STATUS_SUCCESS atau status kesalahan yang sesuai. Ini akan mengatur Irp-IoStatus.Information> ke jumlah byte yang diperlukan untuk menahan struktur USB_ROOT_HUB_NAME. Jika permintaan gagal, driver dapat menggunakan informasi ini untuk mengirim ulang permintaan dengan buffer yang cukup besar.

Persyaratan

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

Lihat juga

USB_ROOT_HUB_NAME