IPnpCallback::OnD0Entry-Methode (wudfddi.h)

Artikel
02/07/2025

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF-.]

Die OnD0Entry- Methode benachrichtigt einen Treiber, wenn ein Gerät in den D0-Energiezustand wechselt, sodass der Treiber erforderliche Vorgänge ausführen kann, z. B. das Aktivieren des Geräts.

Syntax

HRESULT OnD0Entry(
  [in] IWDFDevice             *pWdfDevice,
  [in] WDF_POWER_DEVICE_STATE previousState
);

Parameter

[in] pWdfDevice

Ein Zeiger auf die IWDFDevice Schnittstelle für das Geräteobjekt des Geräts, das in den D0-Energiezustand wechselt.

[in] previousState

Ein WDF_POWER_DEVICE_STATE-typierter Wert, der den Energiezustand des Geräts identifiziert, bevor er in den D0-Energiezustand gelangt ist.

Rückgabewert

Wenn der OnD0Entry Rückruf keine Fehler auftritt, muss er S_OK oder einen anderen Statuscode zurückgeben, für den SUCCEEDED(Status) TRUEist.

Wenn ein Statuscode zurückgegeben wird, für den SUCCEEDED(Status) FALSE-ist, entfernt das Framework das Gerät. Wenn die Treiber des Geräts andere Geräte auf dem System nicht unterstützen, entlädt der E/A-Manager die Treiber. Das Framework benachrichtigt den PnP-Manager, der dann versucht, das Gerät neu zu starten, indem der Bustreiber aufgefordert wird, seine Geräte erneut auflisten zu können. Wenn Der Treiber entladen wurde, wird er neu geladen. In diesem Fall ruft das Framework die IPnpCallback::OnD0Exit Rückruffunktion des Treibers nicht auf.

HRESULT-Fehlercodes werden in Winerror.h definiert.