WdfIoResourceListGetDescriptor, fonction (wdfresource.h)

  • Article

[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)

Voir aussi

IO_RESOURCE_DESCRIPTOR

WdfIoResourceListUpdateDescriptor