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 |
|---|---|
|
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 |