IOCTL_USB_GET_NODE_CONNECTION_INFORMATION IOCTL (usbioctl.h)
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
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