EVT_WDF_DEVICE_FILTER_RESOURCE_REQUIREMENTS funzione di callback (wdffdo.h)

[Si applica solo a KMDF]

La funzione di callback degli eventi EvtDeviceFilterAddResourceRequirements di un driver può aggiungere risorse a un set di requisiti di risorse hardware prima che il sistema assegni le risorse a un dispositivo.

La funzione di callback degli eventi EvtDeviceFilterRemoveResourceRequirements di un driver può rimuovere le risorse da un set di requisiti di risorse hardware prima che il sistema assegni le risorse a un dispositivo.

Sintassi

EVT_WDF_DEVICE_FILTER_RESOURCE_REQUIREMENTS EvtWdfDeviceFilterResourceRequirements;

NTSTATUS EvtWdfDeviceFilterResourceRequirements(
  [in] WDFDEVICE Device,
  [in] WDFIORESREQLIST IoResourceRequirementsList
)
{...}

Parametri

[in] Device

Handle per l'oggetto dispositivo framework a cui verranno assegnate le risorse.

[in] IoResourceRequirementsList

Handle di un oggetto resource-requirements-list, che rappresenta l'elenco dei requisiti delle risorse del dispositivo.

Valore restituito

Se il driver non ha rilevato errori, deve restituire STATUS_SUCCESS. In caso contrario, deve restituire un valore NTSTATUS che NT_SUCCESS restituisce FALSE.

Per altre informazioni sui valori restituiti, vedere Segnalazione di errori dei dispositivi.

Commenti

I driver di funzione basati su framework possono fornire una funzione di callback EvtDeviceFilterAddResourceRequirements e EvtDeviceFilterRemoveResourceRequirements. Per registrare queste funzioni di callback, i driver chiamano WdfFdoInitSetEventCallbacks.

Quando il framework chiama la funzione di callback EvtDeviceFilterAddResourceRequirements di un driver, il driver può aggiungere descrittori di risorse a una configurazione logica e può fornire configurazioni logiche aggiuntive. Questi elementi aggiunti rappresentano le risorse richieste dal driver di funzione per rendere operativo il dispositivo.

Se la funzione di callback EvtDeviceFilterAddResourceRequirements di un driver aggiunge elementi all'elenco dei requisiti delle risorse di un dispositivo e se il gestore PnP assegna le risorse all'elenco dei requisiti del dispositivo, la funzione di callback EvtDeviceRemoveAddedResources del driver deve rimuovere le risorse aggiunte dall'elenco di risorse del dispositivo.

Per aggiungere o rimuovere elementi da un elenco di requisiti delle risorse, il driver chiama i metodi dell'oggetto framework resource-requirements-list e i metodi oggetto framework resource-range-list, che modificano l'oggetto resource-requirements-list rappresentato dal parametro IoResourceRequirementsList .

Per altre informazioni su queste funzioni di callback, vedere Modifica di un elenco di requisiti delle risorse.

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

Per informazioni sulla modifica delle risorse di interrupt ,ad esempio sull'affinità del processore, vedere la sezione Osservazioni di WdfInterruptSetPolicy.

Requisiti

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

Vedi anche

EvtDeviceRemoveAddedResources