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

Aucun

Remarques

Une vérification de bogue 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 de zéro représente le premier objet ajouté à la collection, une valeur d’index d’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 Framework Object Collections

Exemples

Pour obtenir un exemple de code qui utilise WdfCollectionRemoveItem, consultez WdfCollectionGetFirstItem.

Exigences

Voir aussi

WdfCollectionRemove