IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME IOCTL (usbioctl.h)

Permintaan kontrol I/O IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME mengambil nama kunci registri driver yang terkait dengan perangkat yang terhubung ke port yang ditunjukkan.

IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_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_DRIVERKEY_NAME yang dialokasikan pengguna. Pada input, anggota ConnectionIndex dari struktur ini berisi jumlah port yang tersambung dengan perangkat.

Panjang buffer input

Ukuran struktur USB_NODE_CONNECTION_DRIVERKEY_NAME .

Buffer output

Pada output, anggota DriverKeyName dari struktur USB_NODE_CONNECTION_DRIVERKEY_NAME di AssociatedIrp.SystemBuffer berisi nama kunci driver yang terkait dengan perangkat yang terhubung ke port yang ditunjukkan oleh ConnectionIndex.

Anggota ActualLength menunjukkan panjang, dalam byte, dari nama kunci driver. Anggota Parameters.DeviceIoControl.OutputBufferLength menunjukkan ukuran, dalam byte, dari seluruh struktur USB_NODE_CONNECTION_DRIVERKEY_NAME .

Panjang buffer output

Ukuran struktur USB_NODE_CONNECTION_DRIVERKEY_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 penelepon mengalokasikan buffer output yang cukup besar untuk menyimpan semua data output, IoStatus.Information akan sama dengan nilai ActualLength. Jika buffer output cukup besar untuk menyimpan semua data output, IoStatus.Information akan sama dengan sizeof(USB_NODE_CONNECTION_DRIVERKEY_NAME).

Persyaratan

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

Lihat juga

USB_NODE_CONNECTION_DRIVERKEY_NAME