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 vers un objet de liste de ressources framework 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 qui List spécifie.
Valeur de retour
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.
Une vérification des bogues système se produit si le pilote fournit un handle d’objet non valide.
Remarques
Votre pilote ne peut pas modifier le descripteur de ressource qui WdfCmResourceListGetDescriptor récupère.
Pour plus d’informations sur les listes de ressources, consultez Ressources matérielles pour Framework-Based Pilotes.
Exemples
Pour obtenir un exemple de code qui utilise WdfCmResourceListGetDescriptor, consultez WdfCmResourceListGetCount.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.0 |
| version minimale de UMDF | 2.0 |
| d’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) |