WdfIoResourceRequirementsListRemove, fonction (wdfresource.h)

  • Article

[S’applique à KMDF uniquement]

La méthode WdfIoResourceRequirementsListRemove supprime une configuration logique d’une liste de ressources requises.

Syntaxe

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

Paramètres

[in] RequirementsList

Handle d’un objet resource-requirements-list d’infrastructure 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 besoins en ressources spécifiée par RequirementsList .

Valeur de retour

None

Remarques

Un bogue case activée 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 .

Lorsque WdfIoResourceRequirementsListRemove supprime la configuration logique qui a la valeur d’index n, la valeur d’index de la configuration logique suivante passe de n+1 à n.

Pour plus d’informations sur les listes de ressources requises, 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 ressources requises.

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

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1.0
En-tête wdfresource.h (include Wdf.h)
Bibliothèque Wdf01000.sys (consultez Gestion des versions de la bibliothèque d’infrastructure).)
IRQL <=DISPATCH_LEVEL
Règles de conformité DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

WdfIoResourceRequirementsListRemoveByIoResList