IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES IOCTL (usbioctl.h)

  • Artikel

Permintaan kontrol I/O IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES mengambil atribut port yang diperluas Microsoft untuk port tertentu.

IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES 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_ATTRIBUTES yang dialokasikan pengguna. Pada input, pemanggil menentukan nomor port di anggota ConnectionIndex dari struktur USB_NODE_CONNECTION_ATTRIBUTES .

Panjang buffer input

Ukuran struktur USB_NODE_CONNECTION_ATTRIBUTES .

Buffer output

Pada output, struktur USB_NODE_CONNECTION_ATTRIBUTES di AssociatedIrp.SystemBuffer menjelaskan atribut port yang diperluas Microsoft untuk port. Catatan Untuk Windows Vista, Windows Server 2008, dan Windows 7, bidang atribut port yang diperluas Microsoft diatur ke nol.

Untuk Windows XP dan Windows Server 2003, atribut port yang diperluas Microsoft mungkin diatur ke USB_PORTATTR_NO_OVERCURRENT_UI. Nilai ini menunjukkan bahwa antarmuka pengguna akan disembunyikan ketika terjadi terlalu banyak pada port.

Panjang buffer output

Parameters.DeviceIoControl.OutputBufferLength menunjukkan ukuran, dalam byte, data yang dikembalikan di SystemBuffer.

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 belum dimulai atau tidak berfungsi, permintaan akan mengembalikan STATUS_UNSUCCESSFUL.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP, Windows Server 2003, dan yang lebih baru.
Header usbioctl.h (termasuk Usbioctl.h)

Lihat juga

USB_NODE_CONNECTION_ATTRIBUTES