IWDFRemoteTarget::Reopen-Methode (wudfddi.h)

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 für neuere Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]

Die Reopen-Methode öffnet ein Remote-E/A-Ziel erneut, nachdem es vorübergehend geschlossen wurde.

Syntax

HRESULT Reopen();

Rückgabewert

Erneut wird S_OK zurückgegeben, wenn der Vorgang erfolgreich ist. Andernfalls gibt die Methode möglicherweise den folgenden Wert zurück:

Rückgabecode	Beschreibung
E_OUTOFMEMORY	Fehler beim Versuch des Frameworks, Arbeitsspeicher zuzuweisen.

 

Diese Methode gibt möglicherweise einen der anderen Werte zurück, die Winerror.h enthält.

Die Überprüfung des Frameworks meldet einen Fehler, wenn das Framework die Datei nicht öffnen kann.

Hinweise

In der Regel ruft ein Treiber die Rückruffunktion "IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveCanceled" auf, aber Reopen kann stattdessen aufgerufen werden, nachdem OnRemoteTargetRemoveCanceled zurückgibt.

Erneut öffnen verwendet den Datei- oder Schnittstellennamen, den der Treiber zuvor für IWDFRemoteTarget::OpenFileByName oder IWDFRemoteTarget::OpenRemoteInterface angegeben hat. Wenn Sie die Vom Treiber verwendete Datei oder Schnittstelle ändern möchten, kann der Treiber IWDFRemoteTarget::Close aufrufen und dann OpenFileByName oder OpenRemoteInterface anstelle von Reopen aufrufen.

Weitere Informationen zum Erneuten Öffnen und verwenden von Remote-E/A-Zielen in UMDF-basierten Treibern finden Sie unter Steuern des Status eines allgemeinen E/A-Ziels in UMDF.

Beispiele

Das folgende Codebeispiel zeigt eine IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveCanceled-Rückruffunktion , die Erneut öffnen aufruft.

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

Anforderungen

Anforderung	Wert
Ende des Supports	In UMDF 2.0 und höher nicht verfügbar.
Zielplattform	Desktop
UMDF-Mindestversion	1.9
Kopfzeile	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

Weitere Informationen

IWDFRemoteTarget

IWDFRemoteTarget::Close