EVT_WDF_DEVICE_RESOURCES_QUERY funzione di callback (wdfpdo.h)
[Si applica solo a KMDF]
La funzione di callback dell'evento EvtDeviceResourcesQuery di un driver del bus 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 a 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 (se specifica o meno le risorse di configurazione di avvio). Se il driver rileva errori, deve restituire un valore NTSTATUS che NT_SUCCESS valuta come FALSE.
Per altre informazioni sui valori restituiti della funzione di callback, vedere Segnalazione di errori del dispositivo.
Commenti
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 la funzione di callback EvtDeviceResourcesQuery del driver del bus per ottenere un elenco di risorse che specifica la configurazione di avvio per il dispositivo.
Il driver deve popolare l'oggetto elenco 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 i metodi dell'oggetto resource-list framework che aggiungono risorse all'oggetto resource-list rappresentato dal parametro Resources . Per altre informazioni sulle risorse hardware e sulla creazione di elenchi di risorse, vedere Risorse hardware per Framework-Based driver.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1,0 |
| Intestazione | wdfpdo.h (includere Wdf.h) |
| IRQL | PASSIVE_LEVEL |