WdfIoResourceListCreate, fonction (wdfresource.h)
[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) |