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 Anschluss angeschlossen ist, sofern vorhanden.
Clienttreiber müssen diese IOCTL an einer IRQL von PASSIVE_LEVEL senden.
IOCTL_USB_GET_NODE_CONNECTION_INFORMATION ist eine Benutzermodus-E/A-Steuerelementanforderung. Diese Anforderung richtet sich an das USB-Hubgerät (GUID_DEVINTERFACE_USB_HUB).
Hauptcode
Eingabepuffer
Der AssociatedIrp.SystemBuffer Member verweist auf eine vom Benutzer zugewiesene USB_NODE_CONNECTION_INFORMATION Struktur, die die Verbindung beschreibt. Bei eingaben enthält das ConnectionIndex Member dieser Struktur die Portnummer.
Eingabepufferlänge
Die Größe einer USB_NODE_CONNECTION_INFORMATION Struktur.
Ausgabepuffer
Bei der Ausgabe enthält das Parameters.DeviceIoControl.OutputBufferLength Member die Größe der Ausgabedaten. Diese Größe ist variabel, da sie von der Anzahl der Rohre 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.
Bemerkungen
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 und die älteren IOCTL_USB_GET_NODE_CONNECTION_INFORMATION Anforderungsberichte nur niedrige und vollgeschwindigkeitsverbindungen melden kann. 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) |
Siehe auch
IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX