WdfIoResourceListGetDescriptor, fonction (wdfresource.h)
[S’applique uniquement à KMDF]
La méthode WdfIoResourceListGetDescriptor retourne un pointeur vers un descripteur de ressource contenu dans la configuration logique d’une liste de ressources requises.
Syntaxe
PIO_RESOURCE_DESCRIPTOR WdfIoResourceListGetDescriptor(
[in] WDFIORESLIST ResourceList,
[in] ULONG Index
);
Paramètres
[in] ResourceList
Handle d’un objet resource-range-list d’infrastructure qui représente une configuration logique des ressources matérielles pour un appareil.
[in] Index
Valeur de base zéro utilisée comme index dans la configuration logique spécifiée par ResourceList .
Valeur retournée
WdfIoResourceListGetDescriptor retourne un pointeur vers la structure IO_RESOURCE_DESCRIPTOR qui décrit la ressource matérielle que le paramètre Index identifie, si la valeur d’index est valide. Sinon, la méthode retourne NULL.
Un bogue système case activée se produit si le pilote fournit un handle d’objet non valide.
Remarques
Votre pilote ne peut pas modifier le contenu de la structure IO_RESOURCE_DESCRIPTOR que WdfIoResourceListGetDescriptor récupère. Pour modifier un descripteur de ressources, le pilote peut appeler WdfIoResourceListUpdateDescriptor.
Pour plus d’informations sur les listes de ressources requises et les configurations logiques, consultez Ressources matérielles pour les pilotes Framework-Based.
Exemples
Pour obtenir un exemple de code qui utilise WdfIoResourceListGetDescriptor, consultez WdfIoResourceRequirementsListGetIoResList.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| En-tête | wdfresource.h (include Wdf.h) |
| Bibliothèque | Wdf01000.sys (consultez Gestion de version de la bibliothèque d’infrastructure.) |
| IRQL | <=DISPATCH_LEVEL |
| Règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |