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

IRP_MJ_DEVICE_CONTROL

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)

Weitere Informationen

USB_NODE_CONNECTION_ATTRIBUTES