Partager via


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)

Voir aussi

CM_PARTIAL_RESOURCE_DESCRIPTOR