EVT_WDF_DEVICE_REMOVE_ADDED_RESOURCES funzione di callback (wdffdo.h)

  • Articolo

[Si applica solo a KMDF]

La funzione di callback dell'evento EvtDeviceRemoveAddedResources di un driver rimuove le risorse hardware aggiunte dalla funzione di callback del driver EvtDeviceFilterAddResourceRequirements .

Sintassi

EVT_WDF_DEVICE_REMOVE_ADDED_RESOURCES EvtWdfDeviceRemoveAddedResources;

NTSTATUS EvtWdfDeviceRemoveAddedResources(
  [in] WDFDEVICE Device,
  [in] WDFCMRESLIST ResourcesRaw,
  [in] WDFCMRESLIST ResourcesTranslated
)
{...}

Parametri

[in] Device

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

[in] ResourcesRaw

Handle a un oggetto elenco di risorse che identifica le risorse hardware non elaborate assegnate dal gestore PnP al dispositivo.

[in] ResourcesTranslated

Handle a un oggetto elenco di risorse che identifica le risorse hardware tradotte assegnate dal gestore PnP al 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 valuta come FALSE.

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

Commenti

I driver di funzione basati su framework possono fornire una funzione di callback EvtDeviceRemoveAddedResources . Per registrare questa funzione di callback, i driver chiamano WdfFdoInitSetEventCallbacks.

Se un driver fornisce una funzione di callback EvtDeviceFilterAddResourceRequirements che aggiunge risorse all'elenco dei requisiti hardware di un dispositivo, il driver deve anche fornire una funzione di callback EvtDeviceRemoveAddedResources . La funzione di callback EvtDeviceRemoveAddedResources esamina l'elenco di risorse assegnato dal gestore PnP al dispositivo e rimuove le risorse dall'elenco aggiunto dalla funzione di callback EvtDeviceFilterAddResourceRequirements . Se il driver rimuove una risorsa, deve rimuoverla dagli elenchi di risorse non elaborati e tradotti.

Per altre informazioni sugli elenchi di risorse e sull'ordine in cui vengono visualizzate le risorse, vedere risorse hardware non elaborate e tradotte.

Il framework chiama la funzione di callback EvtDeviceRemoveAddedResources immediatamente prima di passare l'elenco delle risorse del dispositivo al driver del bus. Questa funzione di callback rimuove le risorse aggiunte in modo che il driver del bus non tenterà di usarle.

Per altre informazioni sulla funzione di callback EvtDeviceRemoveAddedResources , vedere Modifica di un elenco di risorse.

Per altre informazioni sulle risorse hardware, vedere Risorse hardware per i driver di Framework-Based.

Requisiti

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

Vedi anche

EvtDeviceFilterAddResourceRequirements

EvtDeviceFilterRemoveResourceRequirements