EVT_WDF_DEVICE_REMOVE_ADDED_RESOURCES fonction de rappel (wdffdo.h)

[S’applique uniquement à KMDF]

La fonction de rappel d’événement EvtDeviceRemoveAddedResources d’un pilote supprime les ressources matérielles ajoutées par la fonction de rappel EvtDeviceFilterAddResourceRequirements du pilote.

Syntaxe

EVT_WDF_DEVICE_REMOVE_ADDED_RESOURCES EvtWdfDeviceRemoveAddedResources;

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

Paramètres

[in] Device

Handle à l’objet d’appareil framework auquel les ressources seront affectées.

[in] ResourcesRaw

Handle vers un objet de liste de ressources qui identifie les ressources matérielles brutes que le gestionnaire PnP a attribuées à l’appareil.

[in] ResourcesTranslated

Handle vers un objet de liste de ressources qui identifie les ressources matérielles traduites que le gestionnaire PnP a attribuées à l’appareil.

Valeur de retour

Si le pilote n’a rencontré aucune erreur, il doit retourner STATUS_SUCCESS. Sinon, il doit retourner une valeur NTSTATUS qui NT_SUCCESS est évaluée comme FALSE.

Pour plus d’informations sur les valeurs de retour, consultez Reporting Device Failures.

Remarques

Les pilotes de fonction basés sur l’infrastructure peuvent fournir une fonction de rappel EvtDeviceRemoveAddedResources . Pour inscrire cette fonction de rappel, les pilotes appellent WdfFdoInitSetEventCallbacks.

Si un pilote fournit une fonction de rappel EvtDeviceFilterAddResourceRequirements qui ajoute des ressources à la liste des exigences matérielles d’un appareil, le pilote doit également fournir une fonction de rappel EvtDeviceRemoveAddedResources . La fonction de rappel EvtDeviceRemoveAddedResources examine la liste des ressources que le gestionnaire PnP a attribuée à l’appareil et supprime les ressources de la liste ajoutées par la fonction de rappel EvtDeviceFilterAddResourceRequirements . Si le pilote supprime une ressource, il doit le supprimer des listes de ressources brutes et traduites.

Pour plus d’informations sur les listes de ressources et l’ordre dans lequel les ressources apparaissent, consultez les ressources matérielles brutes et traduites.

L’infrastructure appelle la fonction de rappel EvtDeviceRemoveAddedResources du pilote immédiatement avant de passer la liste de ressources de l’appareil au pilote bus. Cette fonction de rappel supprime les ressources ajoutées afin que le pilote de bus ne tente pas de les utiliser.

Pour plus d’informations sur la fonction de rappel EvtDeviceRemoveAddedResources , consultez Modification d’une liste de ressources.

Pour plus d’informations sur les ressources matérielles, consultez Ressources matérielles pour les pilotes Framework-Based.

Spécifications

   
Plateforme cible Universal
Version KMDF minimale 1.0
En-tête wdffdo.h (include Wdf.h)
IRQL PASSIVE_LEVEL

Voir aussi

EvtDeviceFilterAddResourceRequirements

EvtDeviceFilterRemoveResourceRequirements