Fonction WdfCollectionRemove (wdfcollection.h)
[S’applique à KMDF et UMDF]
La méthode WdfCollectionRemove supprime un objet d’une collection d’objets spécifiée.
Syntaxe
void WdfCollectionRemove(
[in] WDFCOLLECTION Collection,
[in] WDFOBJECT Item
);
Paramètres
[in] Collection
Handle d’un objet de collection.
[in] Item
Handle vers l’objet framework qui sera supprimé de la collection.
Valeur de retour
Aucun
Remarques
Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.
Lorsque WdfCollectionRemove 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 Framework Object Collections.
Exemples
L’exemple de code suivant supprime un objet spécifié d’une collection d’objets spécifiée.
WdfCollectionRemove(
hCollection,
hObject
);
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.0 |
| version minimale de UMDF | 2.0 |
| d’en-tête | wdfcollection.h (include 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) |