共用方式為

IWDFRemoteTarget：：Reopen 方法 （wudfddi.h）

  • 發行項

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

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

語法

HRESULT Reopen();

傳回值

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

傳回碼 描述
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