struktur USB_NODE_CONNECTION_INFORMATION (usbioctl.h)

Artikel
02/26/2024

Struktur USB_NODE_CONNECTION_INFORMATION digunakan dengan permintaan IOCTL_USB_GET_NODE_CONNECTION_INFORMATION untuk mengambil informasi tentang port USB dan perangkat yang terhubung.

Sintaks

typedef struct _USB_NODE_CONNECTION_INFORMATION {
  ULONG                 ConnectionIndex;
  USB_DEVICE_DESCRIPTOR DeviceDescriptor;
  UCHAR                 CurrentConfigurationValue;
  BOOLEAN               LowSpeed;
  BOOLEAN               DeviceIsHub;
  USHORT                DeviceAddress;
  ULONG                 NumberOfOpenPipes;
  USB_CONNECTION_STATUS ConnectionStatus;
  USB_PIPE_INFO         PipeList[0];
} USB_NODE_CONNECTION_INFORMATION, *PUSB_NODE_CONNECTION_INFORMATION;

Anggota

ConnectionIndex

Nilai yang lebih besar dari atau sama dengan 1 yang menentukan jumlah port.

DeviceDescriptor

Struktur USB_DEVICE_DESCRIPTOR yang melaporkan deskriptor perangkat USB yang dikembalikan oleh perangkat yang terpasang selama enumerasi.

CurrentConfigurationValue

Berisi ID yang digunakan dengan permintaan SetConfiguration untuk menentukan konfigurasi perangkat saat ini yang tersambung ke port yang ditunjukkan. Untuk penjelasan tentang nilai ini, lihat bagian 9.4.7 di Spesifikasi Universal Serial Bus 3.1 yang tersedia di USB Document Library.

LowSpeed

Nilai Boolean yang menunjukkan apakah port dan perangkat yang terhubung beroperasi dengan kecepatan rendah. TRUE menunjukkan bahwa port dan perangkat yang terhubung saat ini beroperasi dengan kecepatan rendah. FALSE menunjukkan sebaliknya.

DeviceIsHub

Nilai Boolean yang menunjukkan apakah perangkat yang dilampirkan ke port adalah hub. Jika TRUE, perangkat yang dilampirkan ke port adalah hub. Jika FALSE, perangkat bukan hub.

DeviceAddress

Alamat perangkat yang ditetapkan USB dan relatif bus yang dilampirkan ke port.

NumberOfOpenPipes

Jumlah pipa USB terbuka yang terkait dengan port.

ConnectionStatus

Enumerator jenis USB_CONNECTION_STATUS yang menunjukkan status koneksi.

PipeList[0]

Array struktur USB_PIPE_INFO yang menjelaskan pipa terbuka yang terkait dengan port. Deskripsi pipa mencakup offset jadwal pipa dan deskriptor titik akhir terkait. Informasi ini dapat digunakan untuk menghitung penggunaan bandwidth.

Keterangan

Jika tidak ada perangkat yang terhubung ke port USB, IOCTL_USB_GET_NODE_CONNECTION_INFORMATION hanya mengembalikan informasi tentang port. Jika perangkat tersambung ke port, IOCTL_USB_GET_NODE_CONNECTION_INFORMATION mengembalikan informasi tentang port dan perangkat yang terhubung.

Struktur USB_NODE_CONNECTION_INFORMATION_EX adalah versi USB_NODE_CONNECTION_INFORMATION yang diperluas. Kedua struktur tersebut identik, kecuali satu anggota. Dalam USB_NODE_CONNECTION_INFORMATION_EX, anggota LowSpeed digantikan oleh anggota Speed . LowSpeed adalah nilai Boolean, jadi ketika TRUE, perangkat berkecepatan rendah. Saat FALSE, perangkat berkecepatan tinggi atau berkecepatan penuh. Dengan demikian struktur USB_NODE_CONNECTION_INFORMATION tidak dapat membedakan antara kecepatan tinggi dan penuh.

Anggota Kecepatan dari struktur USB_NODE_CONNECTION_INFORMATION_EX adalah UCHAR dan dapat menentukan salah satu nilai enumerator USB_DEVICE_SPEED .