共用方式為

IWDFRemoteTarget：：Reopen 方法 (wudfddi.h)

  • 發行項

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

重新開啟方法會在遠端 I/O 目標暫時關閉之後重新開啟。

Syntax

HRESULT Reopen();

傳回值

如果作業成功，重新開啟會傳回S_OK。 否則，方法可能會傳回下列值：

傳回碼 Description
E_OUTOFMEMORY
 架構嘗試配置記憶體失敗。
 

這個方法可能會傳回 Winerror.h 包含的其他其中一個值。

如果架構無法開啟檔案，架構的 驗證程式 就會回報錯誤。

備註

一般而言，驅動程式會從IRemoteTargetCallbackRemoval：：OnRemoteTargetRemoveCanceled 回呼函式內呼叫重新開啟，但在 OnRemoteTargetRemoveCanceled 傳回之後，可以改為呼叫重新開啟。

重新開啟會使用驅動程式先前指定給 IWDFRemoteTarget：：OpenFileByName 或 IWDFRemoteTarget：：OpenRemoteInterface 的檔案或介面名稱。 如果您想要變更驅動程式所使用的檔案或介面，驅動程式可以呼叫 IWDFRemoteTarget：：Close，然後它可以呼叫 OpenFileByName 或 OpenRemoteInterface ，而不是 重新開啟。

如需 重新開啟 以及如何在 UMDF 型驅動程式中使用遠端 I/O 目標的詳細資訊，請參閱 控制 UMDF 中的一般 I/O 目標狀態。

範例

下列程式代碼範例顯示呼叫重新開啟的 IRemoteTargetCallbackRemoval：：OnRemoteTargetRemoveCanceled 回呼函式。

VOID 
STDMETHODCALLTYPE
CMyRemoteTarget::OnRemoteTargetRemoveCanceled(
    __in IWDFRemoteTarget* FxTarget
    )
{
 if (S_OK == (FxTarget->Reopen()))
    {
    //
    // Resume sending I/O requests to the remote target.
    //
    ...
    }
 else
    {
       FxTarget->Close();
    }
}

規格需求

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

另請參閱

IWDFRemoteTarget

IWDFRemoteTarget：：Close