EVT_WDF_DEVICE_RESOURCE_REQUIREMENTS_QUERY funzione di callback (wdfpdo.h)

[Si applica solo a KMDF]

La funzione di callback dell'evento EvtDeviceResourceRequirementsQuery di un driver del bus 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 resource-requirements-list framework che rappresenta un elenco di requisiti di risorsa vuoto.

Valore restituito

Se il driver non ha rilevato errori, deve restituire STATUS_SUCCESS (se specifica o meno alcuna risorsa hardware richiesta). 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 EvtDeviceResourceRequirementsQuery . Per registrare questa funzione di callback, i driver del bus chiamano WdfPdoInitSetEventCallbacks.

Il framework chiama la funzione di callback EvtDeviceResourceResourceRequirementsQuery per ottenere un elenco dei requisiti delle risorse per il dispositivo.

Il driver deve popolare l'oggetto resource-requirements-list fornito con configurazioni logiche delle risorse hardware che consentiranno al dispositivo di funzionare correttamente.

Per creare un elenco dei requisiti delle risorse, il driver chiama i metodi dell'oggetto resource-range-list, che aggiungono descrittori di risorse alle configurazioni logiche e ai metodi dell'oggetto resource-requirements-list, che aggiungono configurazioni logiche all'elenco dei requisiti delle risorse.

Per altre informazioni sulle risorse hardware e sulla creazione di elenchi dei requisiti delle risorse, vedere Risorse hardware per i driver di Framework-Based.

Se un driver è in esecuzione in una versione del sistema operativo precedente a Windows 7, un driver del bus può usare EvtDeviceResourceRequirementsQuery per impostare una proprietà del dispositivo in un dispositivo figlio prima di enumerare il figlio.

Per impostare una proprietà del dispositivo in Windows 7 o versioni successive, un driver del bus può fornire una routine di pre-elaborazione per IRP_MN_DEVICE_ENUMERATED.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1,0
Intestazione	wdfpdo.h (includere Wdf.h)
IRQL	PASSIVE_LEVEL

Vedi anche

EvtDeviceResourcesQuery