WdfIoResourceListCreate, fonction (wdfresource.h)

  • Article

[S’applique à KMDF uniquement]

La méthode WdfIoResourceListCreate crée une configuration logique vide, qui peut être remplie et ajoutée à une liste des besoins en ressources.

Syntaxe

NTSTATUS WdfIoResourceListCreate(
  [in]           WDFIORESREQLIST        RequirementsList,
  [in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
  [out]          WDFIORESLIST           *ResourceList
);

Paramètres

[in] RequirementsList

Handle d’un objet resource-requirements-list d’infrastructure qui représente la liste des besoins en ressources d’un appareil.

[in, optional] Attributes

Pointeur vers une structure de WDF_OBJECT_ATTRIBUTES allouée par l’appelant qui contient des attributs pour le nouvel objet. (Le membre ParentObject de la structure doit être NULL.) Ce paramètre est facultatif et peut être WDF_NO_OBJECT_ATTRIBUTES.

[out] ResourceList

Handle pour un objet resource-range-list d’infrastructure qui représente la nouvelle configuration logique.

Valeur retournée

WdfIoResourceListCreate retourne STATUS_SUCCESS si l’opération réussit.

Pour obtenir des valeurs de retour supplémentaires, consultez Erreurs de création d’objets framework.

Un bogue système case activée se produit si le pilote fournit un handle d’objet non valide.

Remarques

Pour plus d’informations sur les listes de ressources requises et les configurations logiques, consultez Ressources matérielles pour les pilotes Framework-Based.

L’objet resource-requirements-list spécifié par l’appelant devient le parent du nouvel objet resource-range-list. Le pilote ne peut pas modifier ce parent, et le membre ParentObject ou la structure WDF_OBJECT_ATTRIBUTES doit avoir la valeur NULL.

Exemples

Pour obtenir un exemple de code qui utilise WdfIoResourceListCreate, consultez WdfIoResourceRequirementsListAppendIoResList.

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 des versions de la bibliothèque d’infrastructure).)
IRQL <=DISPATCH_LEVEL
Règles de conformité DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

WDF_OBJECT_ATTRIBUTES