EVT_WDF_DEVICE_RESOURCE_REQUIREMENTS_QUERY fonction de rappel (wdfpdo.h)
[S’applique à KMDF uniquement]
La fonction de rappel d’événement EvtDeviceResourceResourceRequirementsQuery d’un pilote de bus crée une liste des besoins en ressources qui représente les ressources matérielles requises de l’appareil.
Syntaxe
EVT_WDF_DEVICE_RESOURCE_REQUIREMENTS_QUERY EvtWdfDeviceResourceRequirementsQuery;
NTSTATUS EvtWdfDeviceResourceRequirementsQuery(
[in] WDFDEVICE Device,
[in] WDFIORESREQLIST IoResourceRequirementsList
)
{...}
Paramètres
[in] Device
Handle pour un objet d’appareil d’infrastructure.
[in] IoResourceRequirementsList
Handle d’un objet resource-requirements-list d’infrastructure qui représente une liste des exigences 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 une ressource matérielle requise). 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 EvtDeviceResourceRequirementsQuery . Pour inscrire cette fonction de rappel, les pilotes de bus appellent WdfPdoInitSetEventCallbacks.
L’infrastructure appelle la fonction de rappel EvtDeviceResourceRequirementsQuery du pilote de bus pour obtenir une liste des besoins en ressources pour l’appareil.
Le pilote doit remplir l’objet resource-requirements-list fourni avec des configurations logiques des ressources matérielles qui permettront à l’appareil de fonctionner correctement.
Pour créer une liste des besoins en ressources, le pilote appelle les méthodes d’objet resource-range-list du framework, qui ajoutent des descripteurs de ressources aux configurations logiques, et les méthodes d’objet resource-requirements-list du framework, qui ajoutent des configurations logiques à la liste des exigences de ressources.
Pour plus d’informations sur les ressources matérielles et la création de listes de ressources requises, consultez Ressources matérielles pour les pilotes Framework-Based.
Si un pilote s’exécute sur une version de système d’exploitation antérieure à Windows 7, un pilote de bus peut utiliser EvtDeviceResourceRequirementsQuery pour définir une propriété de périphérique sur un appareil enfant avant d’énumérer l’enfant.
Pour définir une propriété d’appareil sur Windows 7 ou version ultérieure, un pilote de bus peut fournir une routine de prétraitement pour IRP_MN_DEVICE_ENUMERATED.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| En-tête | wdfpdo.h (inclure Wdf.h) |
| IRQL | PASSIVE_LEVEL |