Función WdfCollectionGetFirstItem (wdfcollection.h)
[Se aplica a KMDF y UMDF]
El método WdfCollectionGetFirstItem devuelve un identificador al primer objeto que se encuentra en una colección de objetos.
Sintaxis
WDFOBJECT WdfCollectionGetFirstItem(
[in] WDFCOLLECTION Collection
);
Parámetros
[in] Collection
Identificador de un objeto de colección.
Valor devuelto
WdfCollectionGetFirstItem devuelve un identificador al objeto que está actualmente en la parte delantera de la lista de objetos de la colección especificada o null si la lista está vacía.
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Observaciones
Para obtener más información sobre las colecciones de objetos, vea Framework Object Collections.
Ejemplos
En el ejemplo de código siguiente se quita cada elemento de una colección y se elimina el objeto de cada elemento.
while ((subRequest = WdfCollectionGetFirstItem(hCollection)) != NULL) {
WdfCollectionRemoveItem(
hCollection,
0
);
WdfObjectDelete(subRequest);
}
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| versión mínima de UMDF | 2.0 |
| encabezado de | wdfcollection.h (incluya Wdf.h) |
| biblioteca de | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| irQL | <= DISPATCH_LEVEL |
| reglas de cumplimiento de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |