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