IPnpCallback::OnQueryStop 方法(wudfddi.h)

[警告: UMDF 2 是最新版本的 UMDF,取代了 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 没有将新功能添加到 UMDF 1,并且对较新版本的 Windows 10 上的 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息,请参阅 UMDF入门 。]

OnQueryStop 方法在设备停止前通知驱动程序。

语法

HRESULT OnQueryStop(
  [in] IWDFDevice *pWdfDevice
);

参数

[in] pWdfDevice

指向将停止的设备对象的 IWDFDevice 接口的指针。

返回值

如果驱动程序确定设备可以停止,则 OnQueryStop 回调方法必须返回S_OK或其他状态代码,SUCCEEDED(status) 等于 TRUE 。 否则,它必须返回一个状态代码,SUCCEEDED(status) 等于 FALSE。 HRESULT 错误代码在 Winerror.h 中定义。 不返回HRESULT_FROM_NT(STATUS_NOT_SUPPORTED)。

此方法必须使用 HRESULT_FROM_NT 宏返回特定的 HRESULT 值,以将状态返回到内核模式客户端。 有关详细信息,请参阅 支持内核模式客户端

言论

驱动程序在调用 IWDFDriver::CreateDevice 方法来创建设备对象时注册 IPnpCallback 接口。

该框架不会将 OnQueryStop 回调函数与其他 PnP 和电源管理回调函数同步。

在框架版本 1.7 及更早版本中未调用 OnQueryStop

有关 OnQueryStop 回调方法的详细信息,请参阅 PnP 管理器重新分发系统资源

要求

要求 价值
目标平台 窗户
标头 wudfddi.h (包括 Wudfddi.h)

另请参阅

IPnpCallback

IWDFDevice

IWDFDriver::CreateDevice