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. 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 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- und 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.
Bemerkungen
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 zugeordnet wurden, unabhängig davon, ob OnPrepareHard ware 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 Interrupt-Objekts.
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 |
| Mindest-UMDF-Version | 1.11 |
| Header- | wudfddi.h |