Fonction WdfCollectionGetFirstItem (wdfcollection.h)

[S’applique à KMDF et UMDF]

La méthode WdfCollectionGetFirstItem retourne un handle au premier objet qui se trouve dans une collection d’objets.

Syntaxe

WDFOBJECT WdfCollectionGetFirstItem(
  [in] WDFCOLLECTION Collection
);

Paramètres

[in] Collection

Handle d’un objet de collection.

Valeur retournée

WdfCollectionGetFirstItem retourne un handle à l’objet qui se trouve actuellement à l’avant de la liste d’objets de la collection spécifiée, ou NULL si la liste est vide.

Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.

Remarques

Pour plus d’informations sur les collections d’objets, consultez Collections d’objets Framework.

Exemples

L’exemple de code suivant supprime chaque élément d’une collection et supprime l’objet de chaque élément.

while ((subRequest = WdfCollectionGetFirstItem(hCollection)) != NULL) {
    WdfCollectionRemoveItem(
                            hCollection,
                            0
                            );
    WdfObjectDelete(subRequest);
}

Configuration requise

Voir aussi

WdfCollectionGetItem

WdfCollectionGetLastItem