共用方式為


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 介面。

架構不會與其他 PnP 和電源管理回呼函式同步處理 OnQueryStop 回呼函式。

Framework 1.7 版和更早版本中未呼叫 OnQueryStop

如需 OnQueryStop 回呼方法的詳細資訊,請參閱 PnP 管理員重新發佈系統資源

要求

要求 價值
目標平臺 窗戶
標頭 wudfddi.h (包括 Wudfddi.h)

另請參閱

IPnpCallback

IWDFDevice

IWDFDriver::CreateDevice