EVT_WDF_DEVICE_RESOURCE_REQUIREMENTS_QUERY Rückruffunktion (wdfpdo.h)

[Gilt nur für KMDF]

Die EvtDeviceResourceResourceRequirementsQuery-Ereignisrückruffunktion eines Bustreibers erstellt eine Liste der Ressourcenanforderungen, die die erforderlichen Hardwareressourcen des Geräts darstellt.

Syntax

EVT_WDF_DEVICE_RESOURCE_REQUIREMENTS_QUERY EvtWdfDeviceResourceRequirementsQuery;

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

Parameter

[in] Device

Ein Handle für ein Framework-Geräteobjekt.

[in] IoResourceRequirementsList

Ein Handle für ein Framework resource-requirements-list-Objekt, das eine leere Ressourcenbedarfsliste darstellt.

Rückgabewert

Wenn beim Treiber keine Fehler aufgetreten sind, muss er STATUS_SUCCESS zurückgeben (unabhängig davon, ob er eine erforderliche Hardwareressource angibt oder nicht). Wenn beim Treiber Fehler auftreten, muss er einen NTSTATUS-Wert zurückgeben, der NT_SUCCESS als FALSE auswertet.

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

Hinweise

Frameworkbasierte Bustreiber können eine EvtDeviceResourceRequirerementsQuery-Rückruffunktion bereitstellen. Um diese Rückruffunktion zu registrieren, rufen Bustreiber WdfPdoInitSetEventCallbacks auf.

Das Framework ruft die Rückruffunktion EvtDeviceResourceRequirerementsQuery des Bustreibers auf, um eine Ressourcenbedarfsliste für das Gerät abzurufen.

Der Treiber muss das bereitgestellte Resource-requirements-list-Objekt mit logischen Konfigurationen von Hardwareressourcen auffüllen, damit das Gerät ordnungsgemäß funktioniert.

Um eine Ressourcenbedarfsliste zu erstellen, ruft der Treiber framework resource-range-list-Objektmethoden auf, die ressourcendeskriptoren zu logischen Konfigurationen hinzufügen, und framework resource-requirements-list-Objektmethoden, die der Ressourcenbedarfsliste logische Konfigurationen hinzufügen.

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

Wenn ein Treiber unter einer Früheren Betriebssystemversion als Windows 7 ausgeführt wird, kann ein Bustreiber EvtDeviceResourceRequirementsQuery verwenden, um eine Geräteeigenschaft auf einem untergeordneten Gerät festzulegen, bevor das untergeordnete Gerät aufgelistet wird.

Um eine Geräteeigenschaft unter Windows 7 oder höher festzulegen, kann ein Bustreiber eine Vorverarbeitungsroutine für IRP_MN_DEVICE_ENUMERATED bereitstellen.

Anforderungen

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

Weitere Informationen

EvtDeviceResourcesQuery