IPnpCallback::OnD0Exit-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 OnD0Exit-Methode benachrichtigt einen Treiber, wenn ein Gerät den D0-Energiezustand verlässt, sodass der Treiber erforderliche Vorgänge ausführen kann, z. B. das Deaktivieren des Geräts.

Syntax

HRESULT OnD0Exit(
  [in] IWDFDevice             *pWdfDevice,
  [in] WDF_POWER_DEVICE_STATE newState
);

Parameter

[in] pWdfDevice

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

[in] newState

Ein WDF_POWER_DEVICE_STATE typisierter Wert, der den neuen Energiezustand identifiziert, auf den das Gerät festgelegt ist, nachdem es den D0-Energiezustand beendet hat.

Rückgabewert

Wenn bei der OnD0Exit-Rückrufmethode keine Fehler auftreten, muss sie S_OK oder einen anderen status Code zurückgeben, für den SUCCEEDED(status) gleich TRUE ist. Andernfalls muss ein status Code zurückgegeben werden, für den SUCCEEDED(status) gleich FALSE ist. HRESULT-Fehlercodes sind in Winerror.h definiert.