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

另请参阅

EvtDeviceQueryRemove