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 de l’objet d’appareil framework auquel les ressources seront affectées.

[in] ResourcesRaw

Handle d’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 d’un objet de liste de ressources qui identifie les ressources matérielles traduites que le gestionnaire PnP a attribuées à l’appareil.

Valeur retournée

Si le pilote n’a rencontré aucune erreur, il doit retourner STATUS_SUCCESS. Sinon, il doit retourner une valeur NTSTATUS que NT_SUCCESS évalue comme FALSE.

Pour plus d’informations sur les valeurs de retour, consultez Signalement des échecs d’appareil.

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 de configuration matérielle requise d’un appareil, le pilote doit également fournir une fonction de rappel EvtDeviceRemoveAddedResources . La fonction de rappel EvtDeviceRemoveAddedResources examine la liste de ressources que le gestionnaire PnP a affectée à l’appareil et supprime les ressources de la liste ajoutée par la fonction de rappel EvtDeviceFilterAddResourceRequirements . Si le pilote supprime une ressource, il doit la 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 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 de bus. Cette fonction de rappel supprime des 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.

Configuration requise

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

Voir aussi

EvtDeviceFilterAddResourceRequirements

EvtDeviceFilterRemoveResourceRequirequirements