共用方式為


IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove 方法 (wudfddi.h)

[警告: UMDF 2 是最新版的 UMDF,並取代 UMDF 1。 所有新的 UMDF 驅動程式都應該使用 UMDF 2 來撰寫。 未將新功能新增至 UMDF 1,且較新版本的 Windows 10 上不支援 UMDF 1。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊,請參閱使用 UMDF 使用者入門。]

UMDF 型驅動程式的 OnRemoteTargetQueryRemove 事件回呼函式會決定是否可以停止和移除遠端 I/O 目標的裝置。

語法

BOOL OnRemoteTargetQueryRemove(
  [in] IWDFRemoteTarget *pWdfRemoteTarget
);

參數

[in] pWdfRemoteTarget

表示遠端 I/O 目標的遠端目標物件的 IWDFRemoteTarget 介面指標。 驅動程式會在呼叫 IWDFDevice2::CreateRemoteTarget 時取得此指標。

傳回值

如果驅動程序判斷裝置可以停止並移除, OnRemoteTargetQueryRemove 事件回呼函式必須傳回 TRUE。 否則,回呼函式必須傳回 FALSE

備註

如果您的驅動程式提供 OnRemoteTargetQueryRemove 事件回呼函式,回呼函式應該判斷作業系統是否應該允許移除裝置。 如果驅動程式判斷裝置可以移除,它應該執行下列動作:

  1. 執行任何停止遠端目標 I/O 所需的驅動程式特定動作。
  2. 呼叫 IWDFRemoteTarget::CloseForQueryRemove
  3. 傳回 TRUE ,表示可以進行移除。
如果驅動程式判斷不應該移除裝置,回呼函式必須傳回 FALSE。 一般而言,驅動程式應該避免傳回 FALSE,因為 FALSE 傳回值可能會導致 Windows 重新啟動。

如果驅動程式未提供此回呼函式,架構會呼叫驅動程式的 IWDFRemoteTarget::CloseForQueryRemove 。 換句話說,除非驅動程式提供 OnRemoteTargetQueryRemove 事件回呼函式,否則架構一律允許移除裝置。

如需 OnRemoteTargetQueryRemove 事件回呼函式的詳細資訊,請參閱 控制 UMDF 中的一般 I/O 目標狀態

規格需求

需求
終止支援 UMDF 2.0 和更新版本中無法使用。
目標平台 桌面
最低UMDF版本 1.9
標頭 wudfddi.h (包括 Wudfddi.h)

另請參閱

IRemoteTargetCallbackRemoval

IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveCanceled

IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveComplete