EVT_WDF_DEVICE_RESOURCE_REQUIREMENTS_QUERY funzione di callback (wdfpdo.h)
[Si applica solo a KMDF]
Una funzione di callback degli eventi EvtDeviceResourceResourceRequirementsQuery crea un elenco di requisiti di risorsa che rappresenta le risorse hardware necessarie del dispositivo.
Sintassi
EVT_WDF_DEVICE_RESOURCE_REQUIREMENTS_QUERY EvtWdfDeviceResourceRequirementsQuery;
NTSTATUS EvtWdfDeviceResourceRequirementsQuery(
[in] WDFDEVICE Device,
[in] WDFIORESREQLIST IoResourceRequirementsList
)
{...}
Parametri
[in] Device
Handle per un oggetto dispositivo framework.
[in] IoResourceRequirementsList
Handle per un oggetto framework resource-requirements-list che rappresenta un elenco di requisiti di risorsa vuoto.
Valore restituito
Se il driver non ha rilevato errori, deve restituire STATUS_SUCCESS (indipendentemente dal fatto che specifichi o meno qualsiasi risorsa hardware necessaria). 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 un EvtDeviceResourceRequirementsQuery funzione di callback. Per registrare questa funzione di callback, i driver del bus chiamano WdfPdoInitSetEventCallbacks.
Il framework chiama la funzione di callback del driver del bus EvtDeviceResourceResourceRequirementsQuery per ottenere un elenco di requisiti delle risorse per il dispositivo.
Il driver deve popolare l'oggetto resource-requirements-list fornito con configurazioni logiche di risorse hardware che consentiranno al dispositivo di funzionare correttamente.
Per creare un elenco dei requisiti delle risorse, il driver chiama framework resource-range-list object methods, che aggiungono descrittori di risorse a configurazioni logiche e metodi framework resource-requirements-list object, che aggiungono configurazioni logiche all'elenco dei requisiti delle risorse.
Per altre informazioni sulle risorse hardware e sulla creazione di elenchi di requisiti delle risorse, vedere Risorse hardware per i driver Framework-Based.
Se un driver è in esecuzione in una versione del sistema operativo precedente a Windows 7, un driver del bus può usare EvtDeviceResourceResourceRequirementsQuery per impostare una proprietà del dispositivo in un dispositivo figlio prima di enumerare l'elemento figlio.
Per impostare una proprietà del dispositivo in Windows 7 o versione successiva, un driver del bus può fornire una routine di pre-elaborazione per IRP_MN_DEVICE_ENUMERATED.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| versione minima di KMDF | 1.0 |
| intestazione | wdfpdo.h (include Wdf.h) |
| IRQL | PASSIVE_LEVEL |