EVT_WDF_DEVICE_RESOURCES_QUERY funzione di callback (wdfpdo.h)

[Si applica solo a KMDF]

La funzione di callback di un autista EvtDeviceResourcesQuery crea un elenco di risorse che rappresenta la configurazione di avvio di un dispositivo specificato.

Sintassi

EVT_WDF_DEVICE_RESOURCES_QUERY EvtWdfDeviceResourcesQuery;

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

Parametri

[in] Device

Handle per un oggetto dispositivo framework.

[in] Resources

Handle di un oggetto resource-list framework che rappresenta un elenco di risorse vuoto.

Valore restituito

Se il driver non ha rilevato errori, deve restituire STATUS_SUCCESS (indipendentemente dal fatto che specifichi o meno le risorse di configurazione di avvio). Se il driver rileva errori, deve restituire un valore NTSTATUS che NT_SUCCESS restituisce come FALSE.

Per altre informazioni sui valori restituiti di questa funzione di callback, vedere Segnalazione errori del dispositivo.

Osservazioni:

I driver del bus basati su framework possono fornire una funzione di callback EvtDeviceResourcesQuery. Per registrare questa funzione di callback, i driver del bus chiamano WdfPdoInitSetEventCallbacks.

Il framework chiama il driver del bus EvtDeviceResourcesQuery funzione di callback per ottenere un elenco di risorse che specifica la configurazione di avvio per il dispositivo.

Il driver deve popolare l'oggetto elenco di risorse fornito con risorse hardware che rappresentano i requisiti di avvio per il dispositivo. I driver per i dispositivi PnP ottengono queste informazioni sui requisiti dal BIOS di sistema.

Per creare un elenco di risorse, il driver chiama framework resource-list object che aggiungono risorse all'oggetto elenco di risorse rappresentato dal parametro Resources. Per altre informazioni sulle risorse hardware e sulla creazione di elenchi di risorse, vedere Risorse hardware per i driver Framework-Based.

Requisiti

Vedere anche

EvtDeviceResourceRequirementsQuery