EVT_WDF_DEVICE_RESOURCES_QUERY fonction de rappel (wdfpdo.h)

[S’applique uniquement à KMDF]

La fonction de rappel d’événement EvtDeviceResourcesQuery du pilote 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 vers un objet d’appareil framework.

[in] Resources

Handle vers un objet de liste de ressources framework qui représente une liste de ressources vide.

Valeur de retour

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 que NT_SUCCESS évalue comme FALSE.

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

Remarques

Les pilotes de bus basés sur le framework 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 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 méthodes d’objet de liste de ressources framework qui ajoutent des ressources à l’objet de liste de ressources 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 Framework-Based Pilotes.

Spécifications

Voir aussi

EvtDeviceResourceRequirementsQuery