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