IWDFRemoteTarget::Close-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. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF-.]
Die Close-Methode schließt ein Remote-E/A-Ziel.
Syntax
HRESULT Close();
Rückgabewert
Die Close-Methode gibt immer S_OK zurück.
Bemerkungen
Wenn Ihr Treiber eine IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveComplete- Rückruffunktion bereitstellt, muss die Rückruffunktion Closeaufrufen.
Die Close-Methode schließt alle E/A-Anforderungen ab, die der Treiber an das E/A-Ziel gesendet hat.
Nachdem ein Treiber Closeaufgerufen hat, kann der Treiber keine E/A-Anforderungen an das E/A-Ziel senden.
Weitere Informationen zur methode Close finden Sie unter Controlling a General I/O Target's State in UMDF.
Beispiele
Das folgende Codebeispiel zeigt eine IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveComplete Rückruffunktion, die Closeaufruft.
VOID
STDMETHODCALLTYPE
CMyRemoteTarget::OnRemoteTargetRemoveComplete(
__in IWDFRemoteTarget *FxTarget
)
{
//
// Here, do any driver-specific actions that your driver requires
// to close the remote I/O target.
//
...
//
// Close the target.
//
FxTarget->Close();
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform- | Desktop |
| Mindest-UMDF-Version | 1.9 |
| Header- | wudfddi.h (include Wudfddi.h) |
| DLL- | WUDFx.dll |