WdfCollectionRemoveItem, fonction (wdfcollection.h)

  • Article

[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)

Voir aussi

WdfCollectionRemove