EVT_WDF_DEVICE_RESOURCES_QUERY fonction de rappel (wdfpdo.h)

  • Article

[S’applique à KMDF uniquement]

La fonction de rappel d’événement EvtDeviceResourcesQuery d’un pilote de bus crée une liste de ressources qui représente la configuration de démarrage d’un appareil spécifié.

Syntaxe

EVT_WDF_DEVICE_RESOURCES_QUERY EvtWdfDeviceResourcesQuery;

NTSTATUS EvtWdfDeviceResourcesQuery(
  [in] WDFDEVICE Device,
  [in] WDFCMRESLIST Resources
)
{...}

Paramètres

[in] Device

Handle pour un objet d’appareil d’infrastructure.

[in] Resources

Handle d’un objet de liste de ressources d’infrastructure qui représente une liste de ressources vide.

Valeur retournée

Si le pilote n’a rencontré aucune erreur, il doit retourner STATUS_SUCCESS (qu’il spécifie ou non des ressources de configuration de démarrage). Si le pilote rencontre des erreurs, il doit retourner une valeur NTSTATUS qui NT_SUCCESS a la valeur FALSE.

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

Remarques

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

L’infrastructure appelle la fonction de rappel EvtDeviceResourcesQuery du pilote de bus pour obtenir une liste de ressources qui spécifie la configuration de démarrage de l’appareil.

Le pilote doit remplir l’objet de liste de ressources fourni avec des ressources matérielles qui représentent les exigences de démarrage de l’appareil. Les pilotes pour les appareils PnP obtiennent ces informations requises à partir du BIOS système.

Pour créer une liste de ressources, le pilote appelle des méthodes d’objet resource-list d’infrastructure qui ajoutent des ressources à l’objet resource-list représenté par le paramètre Resources . Pour plus d’informations sur les ressources matérielles et la création de listes de ressources, 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 wdfpdo.h (inclure Wdf.h)
IRQL PASSIVE_LEVEL

Voir aussi

EvtDeviceResourceRequirementsQuery