IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES IOCTL (usbioctl.h)
Die IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES E/A-Steuerungsanforderung ruft die von Microsoft erweiterten Portattribute für einen bestimmten Port ab.
IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES 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_ATTRIBUTES-Struktur . Bei der Eingabe gibt der Aufrufer die Portnummer im ConnectionIndex-Member einer USB_NODE_CONNECTION_ATTRIBUTES-Struktur an.
Länge des Eingabepuffers
Die Größe einer USB_NODE_CONNECTION_ATTRIBUTES-Struktur .
Ausgabepuffer
Bei der Ausgabe beschreibt die USB_NODE_CONNECTION_ATTRIBUTES-Struktur bei AssociatedIrp.SystemBuffer die von Microsoft erweiterten Portattribute für den Port. Hinweis Für Windows Vista, Windows Server 2008 und Windows 7 ist das Feld Microsoft-erweiterte Portattribute auf Null festgelegt.
Für Windows XP und Windows Server 2003 kann das Microsoft-erweiterte Port-Attribut auf USB_PORTATTR_NO_OVERCURRENT_UI festgelegt sein. Dieser Wert gibt an, dass die Benutzeroberfläche ausgeblendet wird, wenn ein Überstrom am Port auftritt.
Länge des Ausgabepuffers
Parameters.DeviceIoControl.OutputBufferLength gibt die Größe der bei SystemBuffer zurückgegebenen Daten in Bytes an.
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. Wenn der Hub nicht gestartet wurde oder nicht funktioniert, gibt die Anforderung STATUS_UNSUCCESSFUL zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP, Windows Server 2003 und höher. |
| Kopfzeile | usbioctl.h (include Usbioctl.h) |