EVT_WDF_DEVICE_FILTER_RESOURCE_REQUIREMENTS fonction de rappel (wdffdo.h)

  • Article

[S’applique à KMDF uniquement]

La fonction de rappel d’événement EvtDeviceFilterAddResourceRequirements d’un pilote peut ajouter des ressources à un ensemble de ressources matérielles requises avant que le système n’affecte des ressources à un appareil.

La fonction de rappel d’événement EvtDeviceFilterRemoveResourceRequirements d’un pilote peut supprimer des ressources d’un ensemble de ressources matérielles requises avant que le système n’affecte des ressources à un appareil.

Syntaxe

EVT_WDF_DEVICE_FILTER_RESOURCE_REQUIREMENTS EvtWdfDeviceFilterResourceRequirements;

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

Paramètres

[in] Device

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

[in] IoResourceRequirementsList

Handle vers un objet resource-requirements-list, qui représente la liste des besoins en ressources de l’appareil.

Valeur retournée

Si le pilote n’a rencontré aucune erreur, il doit retourner STATUS_SUCCESS. Sinon, elle doit retourner une valeur NTSTATUS qui NT_SUCCESS a la valeur FALSE.

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

Remarques

Les pilotes de fonction basés sur l’infrastructure peuvent fournir une fonction de rappel EvtDeviceFilterAddResourceRequirements et une fonction de rappel EvtDeviceFilterRemoveResourceRequirements. Pour inscrire ces fonctions de rappel, les pilotes appellent WdfFdoInitSetEventCallbacks.

Lorsque l’infrastructure appelle la fonction de rappel EvtDeviceFilterAddResourceRequirements d’un pilote, le pilote peut ajouter des descripteurs de ressources à une configuration logique et fournir des configurations logiques supplémentaires. Ces éléments ajoutés représentent les ressources dont le pilote de fonction a besoin pour rendre l’appareil opérationnel.

Si la fonction de rappel EvtDeviceFilterAddResourceRequirements d’un pilote ajoute des éléments à la liste des besoins en ressources d’un appareil et si le gestionnaire PnP affecte les ressources à la liste des exigences de l’appareil, la fonction de rappel EvtDeviceRemoveAddedResources du pilote doit supprimer les ressources ajoutées de la liste des ressources de l’appareil.

Pour ajouter ou supprimer des éléments d’une liste de ressources requises, le pilote appelle les méthodes d’objet resource-requirements-list du framework et les méthodes d’objet resource-range-list du framework, qui manipulent l’objet resource-requirements-list représenté par le paramètre IoResourceRequirementsList .

Pour plus d’informations sur ces fonctions de rappel, consultez Modification d’une liste de ressources requises.

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

Pour plus d’informations sur la modification des ressources d’interruption (par exemple l’affinité processeur), consultez la section Remarques de WdfInterruptSetPolicy.

Configuration requise

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

Voir aussi

EvtDeviceRemoveAddedResources