EVT_WDF_DEVICE_QUERY_STOP回调函数 (wdfdevice.h)
[适用于 KMDF 和 UMDF]
驱动程序的 EvtDeviceQueryStop 事件回调函数确定是否可以停止指定的设备,以便 PnP 管理器可以重新分发系统硬件资源。
语法
EVT_WDF_DEVICE_QUERY_STOP EvtWdfDeviceQueryStop;
NTSTATUS EvtWdfDeviceQueryStop(
[in] WDFDEVICE Device
)
{...}
参数
[in] Device
框架设备对象的句柄。
返回值
如果驱动程序确定设备可以停止,EvtDeviceQueryStop 回调函数必须返回STATUS_SUCCESS或 NT_SUCCESS(状态)等于 TRUE的状态值。 否则,它必须返回一个状态值,NT_SUCCESS(状态)等于 FALSE。 不要返回STATUS_NOT_SUPPORTED。
言论
若要注册 EvtDeviceQueryStop 回调函数,驱动程序必须调用 WdfDeviceInitSetPnpPowerEventCallbacks。
如果设备和驱动程序支持空闲关闭电源,则当框架调用驱动程序的 EvtDeviceQueryStop 回调函数时,设备可能无法处于其工作状态。 回调函数可以调用 WdfDeviceStopIdle 以强制设备进入其工作状态(D0),然后回调函数可以在返回前调用 WdfDeviceResumeIdle。
有关 EvtDeviceQueryStop 回调函数的详细信息,请参阅 处理请求以停止设备。
该框架不会将 EvtDeviceQueryStop 回调函数与其他 PnP 和电源管理回调函数同步。 有关框架如何同步驱动程序事件回调函数的执行的信息,请参阅 使用自动同步。
要求
要求 | 价值 |
---|---|
目标平台 | 普遍 |
最低 KMDF 版本 | 1.0 |
最低 UMDF 版本 | 2.0 |
标头 | wdfdevice.h (包括 Wdf.h) |
IRQL | PASSIVE_LEVEL |