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. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 in neueren 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 Remove-Methode entfernt ein lokales E/A-Ziel.

Syntax

HRESULT Remove(
  [in] BOOL bIsSurpriseRemove
);

Parameter

[in] bIsSurpriseRemove

Ein BOOL-Wert, der bei TRUE angibt, dass das Gerät unerwartet entfernt wurde ("Überraschungsentfernung"). Dieser Parameter wird jedoch vom Framework ignoriert.

Rückgabewert

Remove gibt immer S_OK zurück.

Hinweise

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 dateihandlesbasierte Ziel verwendet hat. Die DeleteWdfObject-Methode führt die von Remove ausgeführten Vorgänge zusammen mit zusätzlichen Vorgängen aus.

Anforderungen

Weitere Informationen

IWDFIoTargetStateManagement