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ätsdarstellt.

Syntax

EVT_WDF_DEVICE_RESOURCES_QUERY EvtWdfDeviceResourcesQuery;

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

Die Parameter

[in] Device

Ein Handle zu einem Framework-Geräteobjekt.

[in] Resources

Ein Handle zu einem Framework-Ressourcenlistenobjekt, das eine leere Ressourcenliste darstellt.

Rückgabewert

Wenn der Treiber keine Fehler aufweist, muss er STATUS_SUCCESS zurückgeben (unabhängig davon, ob er Startkonfigurationsressourcen angibt). Wenn der Treiber Fehler findet, muss ein NTSTATUS-Wert zurückgegeben werden, der NT_SUCCESS als FALSE-ausgewertet wird.

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

Bemerkungen

Frameworkbasierte Bustreiber können eine EvtDeviceResourcesQuery Rückruffunktion bereitstellen. Um diese Rückruffunktion zu registrieren, rufen Bustreiber WdfPdoInitSetEventCallbacksauf.

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

Der Treiber muss das bereitgestellte Ressourcenlistenobjekt mit Hardwareressourcen fü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-Ressourcenlistenobjektmethoden auf, die dem Ressourcenlistenobjekt Ressourcen hinzufügen, das durch den Parameter Resources dargestellt wird. Weitere Informationen zu Hardwareressourcen und zum Erstellen von Ressourcenlisten finden Sie unter Hardwareressourcen für Framework-Based Drivers.

Anforderungen

Siehe auch

EvtDeviceResourceRequirementsQuery