IPnpCallback：：OnD0Entry 方法（wudfddi.h）

项目
02/07/2025

[警告： 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

一个 WDF_POWER_DEVICE_STATE类型化值，该值标识设备进入 D0 电源状态之前的设备电源状态。

返回值

如果 OnD0Entry 回调没有遇到错误，则它必须返回S_OK或 SUCCEEDED（status）等于 TRUE的其他状态代码。

如果它返回一个状态代码，SUCCEEDED（status）等于 FALSE，框架将删除设备。如果设备的驱动程序不支持系统上的其他设备，I/O 管理器将卸载驱动程序。该框架通知 PnP 管理器，然后通过请求总线驱动程序重新生成其设备来尝试重启设备。如果驱动程序已卸载，则会重新加载该驱动程序。在这种情况下，框架不会调用驱动程序的 IPnpCallback：：OnD0Exit 回调函数。

HRESULT 错误代码在 Winerror.h 中定义。