IPnpCallback：：OnD0Entry 方法 (wudfddi.h)

项目
03/05/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

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

返回值

如果 OnD0Entry 回调未遇到任何错误，则必须返回S_OK或其他状态代码，其 SUCCEEDED (状态) 等于 TRUE。

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

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