EVT_UDECX_USB_DEVICE_D0_ENTRY Rückruffunktion (udecxusbdevice.h)

Die ERWEITERUNG der USB-Geräteemulationsklasse (UdeCx) ruft diese Rückruffunktion auf, wenn sie eine Anforderung erhält, das virtuelle USB-Gerät aus einem Zustand mit niedriger Leistung in den Arbeitszustand zu bringen.

Syntax

EVT_UDECX_USB_DEVICE_D0_ENTRY EvtUdecxUsbDeviceD0Entry;

NTSTATUS EvtUdecxUsbDeviceD0Entry(
  [in] WDFDEVICE UdecxWdfDevice,
  [in] UDECXUSBDEVICE UdecxUsbDevice
)
{...}

Parameter

[in] UdecxWdfDevice

Ein Handle zu einem Framework-Geräteobjekt, das den Controller darstellt, an den das USB-Gerät angeschlossen ist. Der Clienttreiber initialisierte dieses Objekt in einem vorherigen Aufruf von UdecxWdfDeviceAddUsbDeviceEmulation.

[in] UdecxUsbDevice

Ein Handle zum UDE-Geräteobjekt. Der Clienttreiber hat dieses Objekt in einem vorherigen Aufruf von UdecxUsbDeviceCreate erstellt.

Rückgabewert

Wenn der Vorgang erfolgreich ist, muss die Rückruffunktion STATUS_SUCCESS zurückgeben oder einen anderen Statuswert zurückgeben, für den NT_SUCCESS(Status) TRUE entspricht.

Hinweise

Der Clienttreiber hat die Funktion in einem vorherigen Aufruf von UdecxUsbDeviceInitSetStateChangeCallbacks registriert, indem ein Funktionszeiger auf seine Implementierung bereitgestellt wird.

In der Rückrufimplementierung wird der Clienttreiber für das USB-Gerät erwartet, dass Schritte ausgeführt werden, um den Arbeitszustand einzugeben.

Die Power-Anforderung kann asynchron abgeschlossen werden, indem STATUS_PENDING zurückgegeben wird, und dann später durch Aufrufen von UdecxUsbDeviceLinkPowerExitComplete mit dem tatsächlichen Abschlusscode abgeschlossen werden.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 10
Unterstützte Mindestversion (Server) Windows Server 2016
Zielplattform Windows
KMDF-Mindestversion 1.15
Header udecxusbdevice.h (include Udecx.h)
IRQL <=DISPATCH_LEVEL

Weitere Informationen

Architektur: USB-Geräteemulation (UDE)

EVT_UDECX_USB_DEVICE_D0_EXIT

UdecxUsbDeviceLinkPowerExitComplete

UdecxUsbDeviceSignalWake

Schreiben eines UDE-Clienttreibers