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 事件回呼函式,回呼函式應該判斷作業系統是否應該允許移除裝置。 如果驅動程式判斷裝置可以移除,它應該執行下列動作:
- 執行任何停止遠端目標 I/O 所需的驅動程式特定動作。
- 呼叫 IWDFRemoteTarget::CloseForQueryRemove。
- 傳回 TRUE ,表示可以進行移除。
如果驅動程式未提供此回呼函式,架構會呼叫驅動程式的 IWDFRemoteTarget::CloseForQueryRemove 。 換句話說,除非驅動程式提供 OnRemoteTargetQueryRemove 事件回呼函式,否則架構一律允許移除裝置。
如需 OnRemoteTargetQueryRemove 事件回呼函式的詳細資訊,請參閱 控制 UMDF 中的一般 I/O 目標狀態。
規格需求
需求 | 值 |
---|---|
終止支援 | UMDF 2.0 和更新版本中無法使用。 |
目標平台 | 桌面 |
最低UMDF版本 | 1.9 |
標頭 | wudfddi.h (包括 Wudfddi.h) |