WdfCmResourceListGetDescriptor, fonction (wdfresource.h)
[S’applique à KMDF et UMDF]
La méthode WdfCmResourceListGetDescriptor retourne un pointeur vers un descripteur de ressource contenu dans une liste de ressources spécifiée.
Syntaxe
PCM_PARTIAL_RESOURCE_DESCRIPTOR WdfCmResourceListGetDescriptor(
[in] WDFCMRESLIST List,
[in] ULONG Index
);
Paramètres
[in] List
Handle d’un objet de liste de ressources d’infrastructure qui représente une liste de 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 List .
Valeur retournée
WdfCmResourceListGetDescriptor retourne un pointeur vers la structure CM_PARTIAL_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 descripteur de ressources que WdfCmResourceListGetDescriptor récupère.
Pour plus d’informations sur les listes de ressources, consultez Ressources matérielles pour les pilotes Framework-Based.
Exemples
Pour obtenir un exemple de code qui utilise WdfCmResourceListGetDescriptor, consultez WdfCmResourceListGetCount.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| Version UMDF minimale | 2.0 |
| En-tête | wdfresource.h (include Wdf.h) |
| Bibliothèque | Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| Règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |