IWDFRemoteTarget::Reopen メソッド (wudfddi.h)

[警告: UMDF 2 は UMDF の最新バージョンであり、UMDF 1 よりも優先されます。 すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、新しいバージョンのWindows 10では UMDF 1 のサポートが制限されています。 ユニバーサル Windows ドライバーでは UMDF 2 を使用する必要があります。 詳細については、「UMDF を使用したはじめに」を参照してください。

Reopen メソッドは、リモート I/O ターゲットが一時的に閉じられた後に再度開きます。

構文

HRESULT Reopen();

戻り値

再度開くと 、操作が成功した場合S_OKが返されます。 それ以外の場合、メソッドは次の値を返す可能性があります。

リターン コード	説明
E_OUTOFMEMORY	フレームワークのメモリの割り当て試行が失敗しました。

 

このメソッドは、Winerror.h に含まれる他の値のいずれかを返す場合があります。

フレームワークの 検証ツール は、フレームワークがファイルを開くことができない場合にエラーを報告します。

注釈

通常、ドライバーは IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveCanceled コールバック関数内から Reopen を呼び出しますが、OnRemoteTargetRemoveCanceled が返された後に、再度開くことができます。

再度開くには、ドライバーが以前に IWDFRemoteTarget::OpenFileByName または IWDFRemoteTarget::OpenRemoteInterface に指定したファイルまたはインターフェイス名を使用します。 ドライバーが使用しているファイルまたはインターフェイスを変更する場合、ドライバーは IWDFRemoteTarget::Close を呼び出し、再度開く代わりに OpenFileByName または OpenRemoteInterface を呼び出すことができます。

再度開く方法と UMDF ベースのドライバーでリモート I/O ターゲットを使用する方法の詳細については、「UMDF での一般的な I/O ターゲットの状態の制御」を参照してください。

例

次のコード例は、Reopen を呼び出す 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
Header	wudfddi.h (Wudfddi.h を含む)
[DLL]	WUDFx.dll

こちらもご覧ください

IWDFRemoteTarget

IWDFRemoteTarget::Close