IPnpCallback::OnD0Entry-Methode (wudfddi.h)

Artikel
03/01/2024

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 in neueren Versionen von Windows 10 ist eingeschränkt. 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 Energiezustand D0 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 typisierter Wert, der den Energiezustand des Geräts vor dem Eintritt in den D0-Energiezustand identifiziert.

Rückgabewert

Wenn für den OnD0Entry-Rückruf keine Fehler auftreten, muss er S_OK oder einen anderen status Code zurückgeben, für den SUCCEEDED(status) gleich TRUE ist.

Wenn ein status Code zurückgegeben wird, für den SUCCEEDED(status) gleich FALSE ist, entfernt das Framework das Gerät. Wenn die Gerätetreiber andere Geräte im 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 er den Bustreiber auffordert, seine Geräte erneut aufzulisten. Wenn Ihr Treiber entladen wurde, wird er erneut geladen. In diesem Fall ruft das Framework die IPnpCallback::OnD0Exit-Rückruffunktion des Treibers nicht auf.

HRESULT-Fehlercodes sind in Winerror.h definiert.