WdfCmResourceListRemove, fonction (wdfresource.h)

  • Article

[S’applique uniquement à KMDF]

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

Syntaxe

void WdfCmResourceListRemove(
  [in] WDFCMRESLIST List,
  [in] ULONG        Index
);

Paramètres

[in] List

Handle d’un objet de liste de ressources d’infrastructure qui représente une liste de ressources matérielles pour un appareil.

[in] Index

Valeur de base zéro utilisée comme index dans la liste de ressources spécifiée par List .

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 WdfCmResourceListRemove supprime le descripteur de ressource associé à la valeur d’index spécifiée par le paramètre Index .

Lorsque WdfCmResourceListRemove 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 les pilotes Framework-Based.

Exemples

L’exemple de code suivant supprime le troisième descripteur de ressources des listes brutes et traduites de ressources matérielles qu’une fonction de rappel EvtDeviceRemoveAddedResources reçoit.

NTSTATUS
MyEvtDeviceRemoveAddedResources(
    WDFDEVICE Device,
    WDFCMRESLIST ResourcesRaw,
    WDFCMRESLIST ResourcesTranslated
    )
{
...
    WdfCmResourceListRemove(
                            ResourcesRaw,
                            2
                            );
    WdfCmResourceListRemove(
                            ResourcesTranslated,
                            2
                            );
...

}

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 de version de la bibliothèque d’infrastructure.)
IRQL <=DISPATCH_LEVEL
Règles de conformité DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

WdfCmResourceListRemoveByDescriptor