EVT_WDF_DEVICE_RESOURCES_QUERY Rückruffunktion (wdfpdo.h)

[Gilt nur für KMDF]

Die EvtDeviceResourcesQuery-Ereignisrückruffunktion eines Bustreibers erstellt eine Ressourcenliste, die die Startkonfiguration eines angegebenen Geräts darstellt.

Syntax

EVT_WDF_DEVICE_RESOURCES_QUERY EvtWdfDeviceResourcesQuery;

NTSTATUS EvtWdfDeviceResourcesQuery(
  [in] WDFDEVICE Device,
  [in] WDFCMRESLIST Resources
)
{...}

Parameter

[in] Device

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

[in] Resources

Ein Handle für ein Frameworkressourcenlistenobjekt, das eine leere Ressourcenliste darstellt.

Rückgabewert

Wenn beim Treiber keine Fehler aufgetreten sind, muss er STATUS_SUCCESS zurückgeben (unabhängig davon, ob er Startkonfigurationsressourcen 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 EvtDeviceResourcesQuery-Rückruffunktion bereitstellen. Um diese Rückruffunktion zu registrieren, rufen Bustreiber WdfPdoInitSetEventCallbacks auf.

Das Framework ruft die Rückruffunktion EvtDeviceResourcesQuery des Bustreibers auf, um eine Ressourcenliste abzurufen, die die Startkonfiguration für das Gerät angibt.

Der Treiber muss das angegebene Ressourcenlistenobjekt mit Hardwareressourcen auffüllen, die die Startanforderungen für das Gerät darstellen. Treiber für PnP-Geräte erhalten diese Anforderungsinformationen aus dem System-BIOS.

Um eine Ressourcenliste zu erstellen, ruft der Treiber framework resource-list-Objektmethoden auf, die ressourcen dem resource-list-Objekt hinzufügen, das durch den Resources-Parameter dargestellt wird. Weitere Informationen zu Hardwareressourcen und zum Erstellen von Ressourcenlisten finden Sie unter Hardwareressourcen für Framework-Based Treiber.

Anforderungen

Weitere Informationen

EvtDeviceResourceRequirementsQuery