WdfCmResourceListRemoveByDescriptor, fonction (wdfresource.h)

Article
02/07/2025

[S’applique uniquement à KMDF]

La méthode WdfCmResourceListRemoveByDescriptor supprime un descripteur de ressource spécifié d’une liste de ressources spécifiée.

Syntaxe

void WdfCmResourceListRemoveByDescriptor(
  [in] WDFCMRESLIST                    List,
  [in] PCM_PARTIAL_RESOURCE_DESCRIPTOR Descriptor
);

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.

[in] Descriptor

Pointeur vers une structure CM_PARTIAL_RESOURCE_DESCRIPTOR qui décrit une ressource matérielle.

Valeur de retour

Aucun

Remarques

Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.

La méthode WdfCmResourceListRemoveByDescriptor supprime le descripteur de ressource qui correspond au paramètre Descriptor. Pour trouver une correspondance, la méthode compare le descripteur de ressource spécifié aux descripteurs de ressource dans la configuration logique, octet pour octet.

Quand WdfCmResourceListRemoveByDescriptor supprime le descripteur de ressource qui a la valeur d’index n, la valeur d’index du descripteur de ressource suivant passe de n+1 à n.

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

Exemples

L’exemple de code suivant recherche les descripteurs de ressources de port dans les listes de ressources d’un appareil. Pour chaque ressource de port que l’exemple trouve, elle vérifie si l’adresse du port se trouve dans une certaine plage. Si l’adresse de port est en dehors de la plage, l’exemple supprime le descripteur des listes de ressources brutes et traduites .

NTSTATUS
MyEvtDeviceRemoveAddedResources(
    WDFDEVICE Device,
    WDFCMRESLIST ResourcesRaw,
    WDFCMRESLIST ResourcesTranslated
    )
{    
    ULONG i, count;

    pDevExt = DeviceGetExtension(Device);
    count = WdfCmResourceListGetCount(ResourcesRaw);

    for (i = 0; i < count; i++) {
        PCM_PARTIAL_RESOURCE_DESCRIPTOR descriptor;

        descriptor = WdfCmResourceListGetDescriptor(
                                                    ResourcesRaw,
                                                    i
                                                    );

        if (descriptor->Type != CmResourceTypePort) {
            continue;
        }

        if (descriptor->u.Port.Start.QuadPart < pDevExt->Ranges[0].MinAddress ||
             descriptor->u.Port.Start.QuadPart > pDevExt->Ranges[0].MaxAddress)
        {
            WdfCmResourceListRemoveByDescriptor(
                                                ResourcesRaw,
                                                descriptor
                                                );

            // The descriptor may not be the same in the raw and translated resource lists, so use an index for the second removal

            WdfCmResourceListRemove(
                                                ResourcesTranslated,
                                                i
                                                );
            break;
        }
    }
}

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

CM_PARTIAL_RESOURCE_DESCRIPTOR

WdfCmResourceListRemove

Partager via