UdecxWdfDeviceAddUsbDeviceEmulation-Funktion (udecxwdfdevice.h)

  • Artikel

Initialisiert ein Frameworkgerätobjekt zur Unterstützung von Vorgängen im Zusammenhang mit einem Hostcontroller und einem virtuellen USB-Gerät, das an den Controller angeschlossen ist.

Syntax

NTSTATUS UdecxWdfDeviceAddUsbDeviceEmulation(
       WDFDEVICE                WdfDevice,
  [in] PUDECX_WDF_DEVICE_CONFIG Config
);

Parameter

WdfDevice

Ein Handle für das Framework-Geräteobjekt, das der Clienttreiber im vorherigen Aufruf von WdfDeviceCreate abgerufen hat.

[in] Config

Ein Zeiger auf eine UDECX_WDF_DEVICE_CONFIG Struktur, die der Clienttreiber durch Aufrufen UDECX_WDF_DEVICE_CONFIG_INIT initialisiert hat.

Rückgabewert

Die -Methode gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode möglicherweise einen geeigneten NTSTATUS-Fehlercode zurück.

Hinweise

Der UDE-Clienttreiber für den emulierten Hostcontroller und das USB-Gerät muss diese Methode nach dem WdfDeviceCreate-Aufruf aufrufen.

Während dieses Aufrufs werden auch die vom Clienttreiber bereitgestellten Ereignisrückrufimplementierungen registriert. Stellen Sie Funktionszeiger auf diese Funktionen bereit, indem Sie die entsprechenden Member von UDECX_WDF_DEVICE_CONFIG.

Die -Methode macht das Framework-Geräteobjekt in der Lage, Vorgänge im Zusammenhang mit einem Controller und seinem Stammhub auszuführen, z. B. die Behandlung verschiedener Warteschlangen, die zum Verarbeiten von IOCTL-Anforderungen erforderlich sind, die an das angeschlossene USB-Gerät gesendet werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10
Unterstützte Mindestversion (Server) Windows Server 2016
Zielplattform Windows
KMDF-Mindestversion 1.15
Kopfzeile udecxwdfdevice.h (include Udecx.h)
Bibliothek Udecxstub.lib
IRQL PASSIVE_LEVEL

Weitere Informationen

Architektur: USB-Geräteemulation (UDE)

Schreiben eines UDE-Clienttreibers