WdfCollectionRemove, fonction (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 de l’objet framework qui sera supprimé de la collection.
Valeur de retour
None
Remarques
Un bogue case activée 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 Collections d’objets Framework.
Exemples
L’exemple de code suivant supprime un objet spécifié d’une collection d’objets spécifiée.
WdfCollectionRemove(
hCollection,
hObject
);
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) |