IOCTL_USB_GET_TRANSPORT_CHARACTERISTICS IOCTL (usbioctl.h)

Artikel
08/07/2023

Der Clienttreiber sendet diese Anforderung, um die Transportmerkmale abzurufen.

Hauptcode

Eingabe-/Ausgabepuffer

Der AssociatedIrp.SystemBuffer-Member ist ein Zeiger auf eine aufruferseitig zugeordnete USB_TRANSPORT_CHARACTERISTICS-Struktur . Legen Sie bei der Eingabe Version auf USB_TRANSPORT_CHARACTERISTICS_VERSION_1 fest. Die Ausgabeversion wird auf eine Version zurückgesetzt, die kleiner oder gleich USB_TRANSPORT_CHARACTERISTICS_VERSION_1 ist. Die verbleibenden Elemente der Struktur werden mit Transportinformationen gefüllt.

Länge des Eingabe-/Ausgabepuffers

Die Größe der USB_TRANSPORT_CHARACTERISTICS-Struktur .

Statusblock

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

Hinweise

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

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 über einen Sicherungsmechanismus für solche Fälle verfügen, in denen die Anforderung erfolgt.

Wenn der Clienttreiber jederzeit die neuesten Informationen kennen möchte, muss er sich zur Benachrichtigung registrieren, wenn sich die Transporteigenschaften ändern, eine Anforderung beim USB-Treiberstapel ausstehend halten 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
Unterstützte Mindestversion (Client)	Windows 10, Version 1709
Unterstützte Mindestversion (Server)	Windows Server 2016
Kopfzeile	usbioctl.h
IRQL	<=DISPATCH_LEVEL