WdfCmResourceListRemove, fonction (wdfresource.h)
[S’applique uniquement à KMDF]
La méthode WdfCmResourceListRemove supprime un descripteur de ressource d’une liste de ressources spécifiée.
Syntaxe
void WdfCmResourceListRemove(
[in] WDFCMRESLIST List,
[in] ULONG Index
);
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] Index
Valeur de base zéro utilisée comme index dans la liste des ressources qui List 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 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 Framework-Based Pilotes.
Exemples
L’exemple de code suivant supprime le troisième descripteur de ressource des listes brutes et traduites de ressources matérielles qu’une EvtDeviceRemoveAddedResources fonction de rappel reçoit.
NTSTATUS
MyEvtDeviceRemoveAddedResources(
WDFDEVICE Device,
WDFCMRESLIST ResourcesRaw,
WDFCMRESLIST ResourcesTranslated
)
{
...
WdfCmResourceListRemove(
ResourcesRaw,
2
);
WdfCmResourceListRemove(
ResourcesTranslated,
2
);
...
}
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) |