WdfCmResourceListGetCount, fonction (wdfresource.h)

Article
02/07/2025

[S’applique à KMDF et UMDF]

La méthode WdfCmResourceListGetCount retourne le nombre de descripteurs de ressources contenus dans une liste de ressources spécifiée.

Syntaxe

ULONG WdfCmResourceListGetCount(
  [in] WDFCMRESLIST List
);

Paramètres

[in] List

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

Valeur de retour

WdfCmResourceListGetCount retourne le nombre de descripteurs de ressources contenus dans la liste des ressources spécifiée par le paramètre 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 ressources, consultez Ressources matérielles pour Framework-Based Pilotes.

Exemples

L’exemple de code suivant montre comment un EvtDevicePrepareHardware fonction de rappel peut localiser la mémoire, le port et les ressources d’interruption dans la liste des ressources matérielles traduites que le gestionnaire Plug-and-Play (PnP) a affecté à un appareil.

NTSTATUS
MyEvtDevicePrepareHardware (
    WDFDEVICE  Device,
    WDFCMRESLIST  Resources,
    WDFCMRESLIST  ResourcesTranslated
    )
{
    ULONG  i;
    PCM_PARTIAL_RESOURCE_DESCRIPTOR  desc;

    for (i = 0; i < WdfCmResourceListGetCount(ResourcesTranslated); i++) {

        desc = WdfCmResourceListGetDescriptor(
                                              ResourcesTranslated,
                                              i
                                              );

        switch (desc->Type) {

            case CmResourceTypeMemory:
                //
                // Handle memory resources here.
                //
                break;

            case CmResourceTypePort:
                //
                // Handle port resources here.
                //
                break;

            case CmResourceTypeInterrupt:
                //
                // Handle interrupt resources here.
                //
                break;
            default:
                //
                // Ignore all other descriptors.
                //
                break;
        }
    }
}

Exigences

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

Partager via