WdfIoResourceRequirementsListAppendIoResList, fonction (wdfresource.h)

Article
02/07/2025

[S’applique uniquement à KMDF]

La méthode WdfIoResourceRequirementsListAppendIoResList ajoute une configuration logique à la fin d’une liste des exigences de ressources.

Syntaxe

NTSTATUS WdfIoResourceRequirementsListAppendIoResList(
  [in] WDFIORESREQLIST RequirementsList,
  [in] WDFIORESLIST    IoResList
);

Paramètres

[in] RequirementsList

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

[in] IoResList

Handle vers un objet de liste de plages de ressources framework qui représente une configuration logique des ressources matérielles pour un appareil.

Valeur de retour

WdfIoResourceRequirementsListAppendIoResList retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette méthode peut retourner l’une des valeurs suivantes :

Retourner le code	Description
STATUS_INVALID_PARAMETER	Un paramètre non valide a été spécifié.
STATUS_INVALID_DEVICE_REQUEST	L’objet resource-requirements-list spécifié ne possède pas l’objet resource-range-list spécifié.
STATUS_INSUFFICIENT_RESOURCES	L’infrastructure n’a pas pu allouer d’espace pour stocker l’objet resource-range-list.

Une vérification des bogues système se produit si le pilote fournit un handle d’objet non valide.

Remarques

Pour plus d’informations sur les listes de configuration requise pour les ressources, consultez Ressources matérielles pour les pilotes Framework-Based.

Exemples

L’exemple de code suivant montre comment une fonction de rappel EvtDeviceResourceRequirementsQuery crée une configuration logique vide et l’ajoute à une liste des besoins en ressources.

NTSTATUS
Example_EvtDeviceResourceRequirementsQuery(
    IN WDFDEVICE Device,
    IN WDFIORESREQLIST RequirementsList
    )
{
    NTSTATUS  status;
    WDFIORESLIST  logConfig;

    status = WdfIoResourceListCreate(
                                     RequirementsList,
                                     WDF_NO_OBJECT_ATTRIBUTES,
                                     &logConfig
                                     );
    if (!NT_SUCCESS(status)) {
        return status;
    }

    status = WdfIoResourceRequirementsListAppendIoResList(
                                             RequirementsList,
                                             logConfig
                                             );
    if (!NT_SUCCESS(status)) {
        return status;
    }
...
}

Exigences

Exigence	Valeur
plateforme cible	Universel
version minimale de KMDF	1.0
d’en-tête	wdfresource.h (include Wdf.h)
bibliothèque	Wdf01000.sys (voir Versioning de la bibliothèque Framework.)
IRQL	<=DISPATCH_LEVEL
règles de conformité DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

WdfIoResourceListCreate

WdfIoResourceRequirementsListInsertIoResList

Partager via