IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE IOCTL (usbioctl.h)
Diese Anforderung registriert sich für Benachrichtigungen über die Änderungen der Transportmerkmale.
Hauptcode
Eingabe-/Ausgabepuffer
Das AssociatedIrp.SystemBuffer-Element ist ein Zeiger auf eine USB_TRANSPORT_CHARACTERISTICS_CHANGE_REGISTRATION-Struktur . Bei der Eingabe kann der Clienttreiber den Typ der Benachrichtigungsänderungen angeben, an denen der Treiber interessiert ist, indem er die Flags im ChangeNotificationInputFlags-Element festlegt.
Bei der Ausgabe wird die Struktur mit dem Registrierungshandle und den Anfangswerten der Transportmerkmale gefüllt.
Länge des Eingabe-/Ausgabepuffers
Die Größe der USB_TRANSPORT_CHARACTERISTICS_CHANGE_REGISTRATION-Struktur .
Statusblock
Irp->IoStatus.Status ist auf STATUS_SUCCESS festgelegt, wenn die Anforderung erfolgreich ist. Andernfalls gibt Status die entsprechende Fehlerbedingung als NTSTATUS-Code an.
Hinweise
Die Transporteigenschaften von MA-USB-Medien können im Laufe der Zeit erheblich variieren. Wenn der Clienttaucher daran interessiert ist, jederzeit die neuesten Informationen zu erhalten, muss sich der Treiber für die Benachrichtigung registrieren, indem er die Anforderung sendet.
Diese Anforderung kann von einer Benutzermodusanwendung, einem UMDF-Treiber oder einem KMDF-Treiber gesendet werden. USB-Treiberstapel überprüft auf veraltete und fehlerhafte Registrierungshandle. Wenn die Anforderung vor der Registrierung und nach der Aufhebung der Registrierung auf einem Handle empfangen wird, schlägt der Treiberstapel die Anforderung fehl.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1709 |
| Unterstützte Mindestversion (Server) | Windows Server 2016 |
| Kopfzeile | usbioctl.h |
| IRQL | <=DISPATCH_LEVEL |
Weitere Informationen
Erstellen von IOCTL-Anforderungen in Treibern
USB-Clienttreiber für Media-Agnostic (MA-USB)
WdfIoTargetSendInternalIoctlOthersSynchronly