Partager via


WdfIoResourceRequirementsListRemove, fonction (wdfresource.h)

[S’applique uniquement à KMDF]

La méthode WdfIoResourceRequirementsListRemove supprime une configuration logique d’une liste des besoins en ressources.

Syntaxe

void WdfIoResourceRequirementsListRemove(
  [in] WDFIORESREQLIST RequirementsList,
  [in] ULONG           Index
);

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] Index

Valeur de base zéro utilisée comme index dans la liste des exigences de ressources qui RequirementsList spécifie.

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 WdfIoResourceRequirementsListRemove supprime la configuration logique associée à la valeur d’index spécifiée par le paramètre Index.

Quand WdfIoResourceRequirementsListRemove supprime la configuration logique qui a la valeur d’index n, la valeur d’index des modifications de configuration logique suivantes de n+1 à n.

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 supprime la deuxième configuration logique d’une liste de conditions requises pour les ressources.

NTSTATUS
Example_EvtDeviceFilterRemoveResourceRequirements(
    IN WDFDEVICE Device,
    IN WDFIORESREQLIST RequirementsList
    )
{
...
    WdfIoResourceRequirementsListRemove(
                                        RequirementsList,
                                        1
                                        );
...
}

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

WdfIoResourceRequirementsListRemoveByIoResList