EVT_WDF_DEVICE_REMOVE_ADDED_RESOURCES Rückruffunktion (wdffdo.h)

[Gilt nur für KMDF]

Die EvtDeviceReviceRemoveAddedResources Ereignisrückruffunktion entfernt Hardwareressourcen, die der Treiber EvtDeviceFilterAddResourceRequirements hinzugefügten Rückruffunktion entfernt.

Syntax

EVT_WDF_DEVICE_REMOVE_ADDED_RESOURCES EvtWdfDeviceRemoveAddedResources;

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

Die Parameter

[in] Device

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

[in] ResourcesRaw

Ein Handle zu einem Ressourcenlistenobjekt, das die rohen Hardwareressourcen identifiziert, die der PnP-Manager dem Gerät zugewiesen hat.

[in] ResourcesTranslated

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

Rückgabewert

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

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

Bemerkungen

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

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

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

Das Framework ruft die EvtDeviceRemoveAddedResources Rückruffunktion auf, 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 EvtDeviceRemoveAddedResources Rückruffunktion finden Sie unter Ändern einer Ressourcenliste.

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

Anforderungen

Siehe auch

EvtDeviceFilterAddResourceRequirements

EvtDeviceFilterRemoveResourceRequirements