WdfCollectionRemoveItem, fonction (wdfcollection.h)
[S’applique à KMDF et UMDF]
La méthode WdfCollectionRemoveItem supprime un objet spécifié d’une collection d’objets, en fonction d’une valeur d’index spécifiée.
Syntaxe
void WdfCollectionRemoveItem(
[in] WDFCOLLECTION Collection,
[in] ULONG Index
);
Paramètres
[in] Collection
Handle d’un objet de collection.
[in] Index
Index de base zéro qui identifie l’objet à supprimer.
Valeur de retour
None
Remarques
Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.
Les valeurs d’index représentent l’ordre dans lequel les objets sont ajoutés à une collection. Une valeur d’index égale à zéro représente le premier objet qui a été ajouté à la collection, une valeur d’index de un représente le deuxième objet, et ainsi de suite.
Lorsque WdfCollectionRemoveItem supprime un objet d’une collection, il décrémente le nombre de références de l’objet.
Pour plus d’informations sur les collections d’objets, consultez Collections d’objets Framework.
Exemples
Pour obtenir un exemple de code qui utilise WdfCollectionRemoveItem, consultez WdfCollectionGetFirstItem.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| Version UMDF minimale | 2.0 |
| En-tête | wdfcollection.h (inclure Wdf.h) |
| Bibliothèque | Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF) |
| IRQL | <= DISPATCH_LEVEL |
| Règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |