[适用于 KMDF 和 UMDF]
驱动程序的 EvtDeviceSelfManagedIoRestart 事件回调函数重启设备的自管理 I/O作。
语法
EVT_WDF_DEVICE_SELF_MANAGED_IO_RESTART EvtWdfDeviceSelfManagedIoRestart;
NTSTATUS EvtWdfDeviceSelfManagedIoRestart(
[in] WDFDEVICE Device
)
{...}
参数
[in] Device
框架设备对象的句柄。
返回值
如果 EvtDeviceSelfManagedIoRestart 回调函数遇到错误，则它必须返回STATUS_SUCCESS，或者返回另一个状态 NT_SUCCESS值（状态）等于 TRUE。 否则，它必须返回一个状态值，NT_SUCCESS（状态）等于 FALSE。 如果NT_SUCCESS（状态）等于 FALSE，框架将停止设备并卸载设备的驱动程序。
如果 NT_SUCCESS（status） 等于 FALSE，则框架将调用驱动程序的 EvtDeviceSelfManagedIoFlush 和 EvtDeviceSelfManagedIoCleanup 回调函数。
有关此回调函数的返回值的详细信息，请参阅 报告设备故障。
言论
若要注册 EvtDeviceSelfManagedIoRestart 回调函数，驱动程序必须调用 WdfDeviceInitSetPnpPowerEventCallbacks。
如果驱动程序注册了 EvtDeviceSelfManagedIoRestart 回调函数，则每当设备从低功率状态返回到其工作状态（D0）状态时，框架都会调用它。 该框架仅在调用驱动程序的 EvtDeviceSelfManagedIoSuspend 回调函数后调用 EvtDeviceSelfManagedIoRestart 回调函数。
驱动程序的 EvtDeviceSelfManagedIoRestart 回调函数必须执行恢复设备的自管理 I/O作所需的任何作。
有关框架何时调用此回调函数的详细信息，请参阅 PnP 和电源管理方案。
有关提供此回调函数的驱动程序的详细信息，请参阅 使用 Self-Managed I/O。
在 IRQL = PASSIVE_LEVEL 调用 EvtDeviceSelfManagedIoRestart 回调函数。 不应将此回调函数 可分页。
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 普遍 |
| 最低 KMDF 版本 | 1.0 |
| 最低 UMDF 版本 | 2.0 |
| 标头 | wdfdevice.h （包括 Wdf.h） |
| IRQL | PASSIVE_LEVEL（请参阅“备注”部分） |