EVT_WDF_DEVICE_FILTER_RESOURCE_REQUIREMENTS Rückruffunktion (wdffdo.h)

[Gilt nur für KMDF]

Die EvtDeviceFilterAddResourceRequirements-Ereignisrückruffunktion eines Treibers kann Ressourcen zu einer Reihe von Hardwareressourcenanforderungen hinzufügen, bevor das System Ressourcen einem Gerät zuweist.

Die EvtDeviceFilterRemoveRemoveResourceRequirements-Ereignisrückruffunktion eines Treibers kann Ressourcen aus einer Reihe von Hardwareressourcenanforderungen entfernen, bevor das System Einem Gerät Ressourcen zuweist.

Syntax

EVT_WDF_DEVICE_FILTER_RESOURCE_REQUIREMENTS EvtWdfDeviceFilterResourceRequirements;

NTSTATUS EvtWdfDeviceFilterResourceRequirements(
  [in] WDFDEVICE Device,
  [in] WDFIORESREQLIST IoResourceRequirementsList
)
{...}

Parameter

[in] Device

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

[in] IoResourceRequirementsList

Ein Handle für ein resource-requirements-list-Objekt, das die Ressourcenbedarfsliste des Geräts darstellt.

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 EvtDeviceFilterAddResourceRequirequirements - und eine EvtDeviceFilterRemoveResourceResourceRequirements-Rückruffunktionbereitstellen. Um diese Rückruffunktionen zu registrieren, rufen Treiber WdfFdoInitSetEventCallbacks auf.

Wenn das Framework die Rückruffunktion EvtDeviceFilterAddResourceRequirements eines Treibers aufruft, kann der Treiber ressourcendeskriptoren zu einer logischen Konfiguration hinzufügen und zusätzliche logische Konfigurationen bereitstellen. Diese hinzugefügten Elemente stellen Ressourcen dar, die der Funktionstreiber benötigt, um das Gerät betriebsbereit zu machen.

Wenn die EvtDeviceFilterAddRequirequirements-Rückruffunktion eines Treibers Elemente zur Liste der Ressourcenanforderungen eines Geräts hinzufügt und der PnP-Manager die Ressourcen der Anforderungsliste des Geräts zuweist, muss die EvtDeviceRemoveAddedResources-Rückruffunktion des Treibers die hinzugefügten Ressourcen aus der Ressourcenliste des Geräts entfernen.

Um Elemente zu einer Ressourcenanforderungsliste hinzuzufügen oder Elemente aus dieser Liste zu entfernen, ruft der Treiber framework resource-requirements-list-Objektmethoden und Framework resource-range-list-Objektmethoden auf, wodurch das resource-requirements-list-Objekt bearbeitet wird, das durch den IoResourceRequirementsList-Parameter dargestellt wird.

Weitere Informationen zu diesen Rückruffunktionen finden Sie unter Ändern einer Ressourcenbedarfsliste.

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

Informationen zum Ändern von Interruptressourcen (z. B. Prozessoraffinität) finden Sie im Abschnitt Hinweise von WdfInterruptSetPolicy.

Anforderungen

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

Weitere Informationen

EvtDeviceRemoveAddedResources