EVT_WDF_DEVICE_REMOVE_ADDED_RESOURCES Rückruffunktion (wdffdo.h)

[Gilt nur für KMDF]

Die EvtDeviceRemoveAddedResources-Ereignisrückruffunktion eines Treibers entfernt Hardwareressourcen, die der EvtDeviceFilterAddResourceRequirements-Rückruffunktion des Treibers hinzugefügt wurden.

Syntax

EVT_WDF_DEVICE_REMOVE_ADDED_RESOURCES EvtWdfDeviceRemoveAddedResources;

NTSTATUS EvtWdfDeviceRemoveAddedResources(
  [in] WDFDEVICE Device,
  [in] WDFCMRESLIST ResourcesRaw,
  [in] WDFCMRESLIST ResourcesTranslated
)
{...}

Parameter

[in] Device

Ein Handle für das Framework-Geräteobjekt, dem Ressourcen zugewiesen werden.

[in] ResourcesRaw

Ein Handle für ein Ressourcenlistenobjekt, das die rohen Hardwareressourcen identifiziert, die der PnP-Manager dem Gerät zugewiesen hat.

[in] ResourcesTranslated

Ein Handle für ein Ressourcenlistenobjekt, das die übersetzten Hardwareressourcen identifiziert, die der PnP-Manager dem Gerät zugewiesen hat.

Rückgabewert

Wenn beim Treiber keine Fehler aufgetreten sind, muss er STATUS_SUCCESS zurückgeben. Andernfalls muss ein NTSTATUS-Wert zurückgegeben werden, der NT_SUCCESS als FALSE auswertet.

Weitere Informationen zu Rückgabewerten finden Sie unter Melden von Gerätefehlern.

Hinweise

Frameworkbasierte Funktionstreiber können eine EvtDeviceRemoveAddedResources-Rückruffunktion bereitstellen. Um diese Rückruffunktion zu registrieren, rufen Treiber WdfFdoInitSetEventCallbacks auf.

Wenn ein Treiber eine EvtDeviceFilterAddResourceRequirements-Rückruffunktion bereitstellt, die Ressourcen zur Hardwareanforderungenliste eines Geräts hinzufügt, muss der Treiber auch eine EvtDeviceRemoveAddedResources-Rückruffunktion bereitstellen. Die Rückruffunktion EvtDeviceRemoveAddedResources untersucht die Ressourcenliste, die der PnP-Manager dem Gerät zugewiesen hat, und entfernt die Ressourcen aus der Liste, die die Rückruffunktion EvtDeviceFilterAddRequirequirements hinzugefügt hat. Wenn der Treiber eine Ressource entfernt, muss sie sowohl aus den Rohdatenlisten als auch aus der übersetzten Ressourcenliste entfernt werden.

Weitere Informationen zu Ressourcenlisten und der Reihenfolge, in der die Ressourcen angezeigt werden, finden Sie unter Unformatierte und übersetzte Hardwareressourcen.

Das Framework ruft die Rückruffunktion EvtDeviceRemoveAddedResources des Treibers auf, unmittelbar bevor die Ressourcenliste des Geräts an den Bustreiber übergeben wird. Diese Rückruffunktion entfernt hinzugefügte Ressourcen, sodass der Bustreiber nicht versucht, sie zu verwenden.

Weitere Informationen zur Rückruffunktion EvtDeviceRemoveAddedResources finden Sie unter Ändern einer Ressourcenliste.

Weitere Informationen zu Hardwareressourcen finden Sie unter Hardwareressourcen für Framework-Based Treiber.

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
Kopfzeile wdffdo.h (einschließen von Wdf.h)
IRQL PASSIVE_LEVEL

Weitere Informationen

EvtDeviceFilterAddResourceRequirerements

EvtDeviceFilterRemoveResourceRequirerements