WdfIoResourceRequirementsListGetCount, fonction (wdfresource.h)

Article
02/07/2025

[S’applique uniquement à KMDF]

La méthode WdfIoResourceRequirementsListGetCount retourne le nombre de configurations logiques contenues dans une liste des exigences de ressources.

Syntaxe

ULONG WdfIoResourceRequirementsListGetCount(
  [in] WDFIORESREQLIST RequirementsList
);

Paramètres

[in] RequirementsList

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

Valeur de retour

WdfIoResourceRequirementsListGetCount retourne le nombre de configurations logiques contenues dans la liste des exigences de ressources.

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 EvtDeviceFilterRemoveResourceRequirements fonction de rappel peut obtenir le nombre de configurations logiques contenues dans une liste des exigences de ressources.

NTSTATUS
Example_EvtDeviceFilterRemoveResourceRequirements(
    IN WDFDEVICE Device,
    IN WDFIORESREQLIST RequirementsList
    )
{    
    ULONG count;

    count = WdfIoResourceRequirementsListGetCount(RequirementsList);
}

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)

Partager via