IPnpCallbackHardware::OnReleaseHardware-Methode (wudfddi.h)

Artikel
03/05/2024

[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 OnReleaseHardware-Methode benachrichtigt einen Treiber, vorgänge auszuführen, die erforderlich sind, wenn auf die angegebene Hardware nicht mehr zugegriffen werden kann.

Syntax

HRESULT OnReleaseHardware(
  [in] IWDFDevice *pWdfDevice
);

Parameter

[in] pWdfDevice

Ein Zeiger auf die IWDFDevice-Schnittstelle für das Geräteobjekt des Geräts, auf das nicht mehr zugegriffen werden kann.

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.

Diese Methode muss das makro HRESULT_FROM_NT verwenden, um einen bestimmten HRESULT-Wert zurückzugeben, um status an einen Kernelmodusclient zurückzugeben. Weitere Informationen finden Sie unter Unterstützen von Kernelmodusclients.

Hinweise

Ein Treiber registriert die IPnpCallbackHardware-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 IPnpCallbackHardware::OnPrepareHardware-Methode des Treibers zugeordnet wurden, unabhängig davon, ob OnPrepareHardware erfolgreich war oder fehlgeschlagen ist. Daher muss OnReleaseHardware in der Lage sein, die Bereinigung von Teilressourcen zu verarbeiten.

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