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 Energiesparzustand in den Arbeitszustand zu versetzen.
Syntax
EVT_UDECX_USB_DEVICE_D0_ENTRY EvtUdecxUsbDeviceD0Entry;
NTSTATUS EvtUdecxUsbDeviceD0Entry(
[in] WDFDEVICE UdecxWdfDevice,
[in] UDECXUSBDEVICE UdecxUsbDevice
)
{...}
Parameter
[in] UdecxWdfDevice
Ein Handle für ein 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 für UDE-Geräteobjekt. Der Clienttreiber hat dieses Objekt in einem vorherigen Aufruf von UdecxUsbDeviceCreateerstellt.
Rückgabewert
Wenn der Vorgang erfolgreich ist, muss die Rückruffunktion STATUS_SUCCESS oder einen anderen Statuswert zurückgeben, für den NT_SUCCESS(Status) WAHR ist.
Bemerkungen
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 erwartet, dass der Clienttreiber für das USB-Gerät Schritte ausführt, um in den Arbeitszustand zu gelangen.
Die Energieanforderung kann asynchron abgeschlossen werden, indem STATUS_PENDING zurückgegeben und später durch Aufrufen von UdecxUsbDeviceLinkPowerExitComplete mit dem tatsächlichen Abschlusscode abgeschlossen wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10 |
| mindestens unterstützte Server- | Windows Server 2016 |
| Zielplattform- | Fenster |
| Minimale KMDF-Version | 1.15 |
| Header- | udecxusbdevice.h (include Udecx.h) |
| IRQL- | <=DISPATCH_LEVEL |
Siehe auch
Architektur: USB Device Emulation (UDE)