IPnpCallbackHardware2::OnReleaseHardware-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 OnReleaseHardware-Methode führt Vorgänge aus, die erforderlich sind, wenn auf ein Gerät nicht mehr zugegriffen werden kann.

Syntax

HRESULT OnReleaseHardware(
  [in] IWDFDevice3        *pWdfDevice,
  [in] IWDFCmResourceList *pWdfResourcesTranslated
);

Parameter

[in] pWdfDevice

Ein Zeiger auf die IWDFDevice3-Schnittstelle für das Framework-Geräteobjekt.

[in] pWdfResourcesTranslated

Ein Zeiger auf die IWDFCmResourceList-Schnittstelle für das Framework-Ressourcenlistenobjekt, das die übersetzten Hardwareressourcen identifiziert, die der Plug & Play-Manager dem Gerät zugewiesen hat.

Rückgabewert

OnReleaseHardware gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode einen der Fehlercodes zurück, die in Winerror.h definiert sind. Geben Sie HRESULT_FROM_NT(STATUS_NOT_SUPPORTED) nicht zurück.

Hinweise

Ein Treiber registriert die IPnpCallbackHardware2-Schnittstelle , wenn der Treiber die IWDFDriver::CreateDevice-Methode aufruft , um ein Geräteobjekt zu erstellen.

Die OnReleaseHardware-Methode muss Ressourcen freigeben, die während des Aufrufs der IPnpCallbackHardware2::OnPrepareHardware-Methode des Treibers zugewiesen wurden, unabhängig davon, ob OnPrepareHardware erfolgreich war oder fehlgeschlagen ist. Daher muss OnReleaseHardware in der Lage sein, die Bereinigung teilweiser Ressourcen zu verarbeiten.

Informationen zum Löschen eines Interruptobjekts finden Sie unter Löschen eines Interruptobjekts.

Informationen zum Analysieren von Hardwareressourcen finden Sie unter Suchen und Zuordnen von Hardwareressourcen in einem UMDF-Treiber.

Beispiele

Siehe Beispielcode in IWDFDevice3::MapIoSpace.

Anforderungen

Anforderung	Wert
Ende des Supports	In UMDF 2.0 und höher nicht verfügbar.
Zielplattform	Desktop
UMDF-Mindestversion	1.11
Kopfzeile	wudfddi.h

Weitere Informationen

IPnpCallbackHardware2

OnPrepareHardware