IPnpCallbackHardware::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. 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 OnReleaseHardware- Methode benachrichtigt einen Treiber, um Vorgänge auszuführen, die erforderlich sind, wenn auf die angegebene Hardware nicht mehr zugegriffen werden kann.
HRESULT OnReleaseHardware(
[in] IWDFDevice *pWdfDevice
);
[in] pWdfDevice
Ein Zeiger auf die IWDFDevice Schnittstelle für das Geräteobjekt des Geräts, auf das nicht mehr zugegriffen werden kann.
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 HRESULT_FROM_NT Makro verwenden, um einen bestimmten HRESULT-Wert zurückzugeben, um den Status an einen Kernelmodusclient zurückzugeben. Weitere Informationen finden Sie unter Unterstützen von Kernelmodusclients.
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 zugeordnet wurden, ob OnPrepareHard ware erfolgreich war oder fehlgeschlagen ist. Daher muss OnReleaseHardware- in der Lage sein, die Bereinigung teilweiser Ressourcen zu verarbeiten.
Weitere Informationen finden Sie unter Suchen und Zuordnen von Hardwareressourcen in einem UMDF-Treiber.
| Anforderung | Wert |
|---|---|
| Zielplattform- | Fenster |
| Header- | wudfddi.h (include Wudfddi.h) |
IPnpCallbackHardware2::OnReleaseHardware