IOCTL_USB_GET_TRANSPORT_CHARACTERISTICS IOCTL (usbioctl.h)

Artikel
02/07/2025

Der Clienttreiber sendet diese Anforderung, um die Transportmerkmale abzurufen.

Hauptcode

Eingabe-/Ausgabepuffer

Der AssociatedIrp.SystemBuffer Member ist ein Zeiger auf eine USB_TRANSPORT_CHARACTERISTICS Struktur zugeordnete Aufrufer. Legen Sie bei der Eingabe Version auf USB_TRANSPORT_CHARACTERISTICS_VERSION_1 fest. Bei der Ausgabe Version wird auf eine Version zurückgesetzt, die kleiner oder gleich USB_TRANSPORT_CHARACTERISTICS_VERSION_1 ist; er verbleibende Mitglieder der Struktur wird mit Transportinformationen gefüllt.

Länge des Eingabe-/Ausgabepuffers

Die Größe der USB_TRANSPORT_CHARACTERISTICS Struktur.

Statusblock

Irp->IoStatus.Status auf STATUS_SUCCESS festgelegt ist, wenn die Anforderung erfolgreich ist. Andernfalls Status der entsprechenden Fehlerbedingung als NTSTATUS- Code.

Bemerkungen

Diese Anforderung ruft die Transportmerkmale ab, um einen Algorithmus für streaming zu entscheiden. Beispielsweise kann ein Anzeigetreiber die Latenz- und Bandbreiteninformationen verwenden, um die Codecauswahl zu bestimmen.

Diese Informationen sind möglicherweise nicht immer verfügbar. Der USB-Treiberstapel hängt vom zugrunde liegenden Transport ab, um diese Werte verfügbar zu machen. Daher muss der Clienttreiber für solche Fälle, in denen die Anforderung angefordert wird, über einen Sicherungsmechanismus verfügen.

Wenn der Clienttreiber jederzeit an der Kenntnis der neuesten Informationen interessiert ist, muss der Treiber sich für die Benachrichtigung registrieren, wenn sich die Transportmerkmale ändern, eine Anforderung mit dem USB-Treiberstapel ausstehen und die Registrierung aufheben, wenn die Benachrichtigung nicht mehr erforderlich ist. Der Treiber kann alle diese Aufgaben ausführen, indem er diese IOCTL-Anforderungen sendet.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10, Version 1709
mindestens unterstützte Server-	Windows Server 2016
Header-	usbioctl.h
IRQL-	<=DISPATCH_LEVEL