IPnpCallback：：OnD0Entry 方法 (wudfddi.h)

發行項
03/01/2024

[警告： UMDF 2 是最新版的 UMDF，並取代 UMDF 1。所有新的 UMDF 驅動程式都應該使用 UMDF 2 來撰寫。未將新功能新增至 UMDF 1，且較新版本的 Windows 10 上不支援 UMDF 1。通用 Windows 驅動程式必須使用 UMDF 2。如需詳細資訊，請參閱使用 UMDF 使用者入門。]

OnD0Entry 方法會在裝置進入 D0 電源狀態時通知驅動程式，讓驅動程式可以執行必要的作業，例如啟用裝置。

語法

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

參數

[in] pWdfDevice

輸入 D0 電源狀態之裝置物件的 IWDFDevice 介面指標。

[in] previousState

在裝置進入 D0 電源狀態之前，識別裝置電源狀態的WDF_POWER_DEVICE_STATE型別值。

傳回值

如果 OnD0Entry 回呼沒有發生任何錯誤，它必須傳回S_OK或另一個狀態代碼，而 SUCCEEDED (狀態) 等於 TRUE。

如果它傳回 SUCCEEDED (狀態) 等於 FALSE 的狀態代碼，架構會移除裝置。如果裝置的驅動程式不支持系統上的其他裝置，I/O 管理員會卸除驅動程式。架構會通知 PnP 管理員，然後藉由要求總線驅動程式繼續其裝置來嘗試重新啟動裝置。如果您的驅動程式已卸除，則會重載它。在此情況下，架構不會呼叫驅動程式的 IPnpCallback：：OnD0Exit 回呼函式。

HRESULT 錯誤碼定義於 Winerror.h 中。