Partager via


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)

Voir aussi

WdfCollectionRemoveItem