IOCTL_USB_GET_NODE_CONNECTION_INFORMATION IOCTL (usbioctl.h)

  • Artikel

Die IOCTL_USB_GET_NODE_CONNECTION_INFORMATION Anforderung ruft Informationen über den angegebenen USB-Anschluss und das Gerät ab, das an den Port angeschlossen ist, sofern vorhanden.

Clienttreiber müssen diese IOCTL an eine IRQL mit PASSIVE_LEVEL senden.

IOCTL_USB_GET_NODE_CONNECTION_INFORMATION ist eine E/A-Steuerungsanforderung für den Benutzermodus. Diese Anforderung zielt auf das USB-Hubgerät (GUID_DEVINTERFACE_USB_HUB) ab.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Der AssociatedIrp.SystemBuffer-Member verweist auf eine vom Benutzer zugewiesene USB_NODE_CONNECTION_INFORMATION Struktur, die die Verbindung beschreibt. Bei der Eingabe enthält der ConnectionIndex-Member dieser Struktur die Portnummer.

Länge des Eingabepuffers

Die Größe einer USB_NODE_CONNECTION_INFORMATION-Struktur .

Ausgabepuffer

Bei der Ausgabe enthält der Parameter.DeviceIoControl.OutputBufferLength-Member die Größe der Ausgabedaten. Diese Größe ist variabel, da sie von der Anzahl der Pipes abhängt, die dem Port zugeordnet sind.

AssociatedIrp.SystemBuffer verweist auf eine vom Benutzer zugewiesene USB_NODE_CONNECTION_INFORMATION-Struktur , die die Ausgabedaten enthält.

Länge des Ausgabepuffers

Die Größe einer USB_NODE_CONNECTION_INFORMATION-Struktur .

Statusblock

Der USB-Stapel legt Irp-IoStatus.Status> auf STATUS_SUCCESS fest, wenn die Anforderung erfolgreich ist. Andernfalls legt der USB-Stapel Status auf die entsprechende Fehlerbedingung fest, z. B. STATUS_INVALID_PARAMETER oder STATUS_INSUFFICIENT_RESOURCES.

Hinweise

Die IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX-Anforderung ist eine erweiterte Version von IOCTL_USB_GET_NODE_CONNECTION_INFORMATION. Die beiden Anforderungen sind identisch, mit der Ausnahme, dass die erweiterte Version der Anforderung niedrige, vollständige und hochgeschwindigkeitsverbindungen melden kann und die älteren IOCTL_USB_GET_NODE_CONNECTION_INFORMATION Anforderung nur Verbindungen mit niedriger und voller Geschwindigkeit meldet. Weitere Informationen zum Unterschied zwischen diesen beiden Anforderungen finden Sie unter USB_NODE_CONNECTION_INFORMATION und USB_NODE_CONNECTION_INFORMATION_EX.

Anforderungen

Anforderung Wert
Header usbioctl.h (include Usbioctl.h)

Weitere Informationen

IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX

USB_NODE_CONNECTION_INFORMATION

USB_NODE_CONNECTION_INFORMATION_EX