IWDFIoTargetStateManagement::Remove-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 methode Remove entfernt ein lokaleS E/A-Ziel.
Syntax
HRESULT Remove(
[in] BOOL bIsSurpriseRemove
);
Parameter
[in] bIsSurpriseRemove
Ein BOOL-Wert, der, wenn TRUE, angibt, dass das Gerät unerwartet entfernt wurde ("Überraschungsentfernung"). Das Framework ignoriert diesen Parameter jedoch.
Rückgabewert
Remove gibt immer S_OK zurück.
Bemerkungen
Obwohl die Remove-Methode verfügbar ist, müssen Treiber sie nicht aufrufen. Wenn ein Treiber IWDFFileHandleTargetFactory::CreateFileHandleTarget aufgerufen hat, um ein dateihandlesbasiertes E/A-Ziel zu erstellen, sollte der Treiber IWDFObject::D eleteWdfObject aufrufen, um das E/A-Zielobjekt zu löschen, nachdem der Treiber das Dateihandle-basierte Ziel verwendet hat. Die DeleteWdfObject--Methode führt die Vorgänge aus, die Remove sowie weitere Vorgänge ausführen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform- | Desktop |
| Mindest-UMDF-Version | 1.5 |
| Header- | wudfddi.h (include Wudfddi.h) |
| DLL- | WUDFx.dll |