Función WdfCollectionGetCount (wdfcollection.h)
[Se aplica a KMDF y UMDF]
El método WdfCollectionGetCount devuelve el número de objetos que se encuentran actualmente en una colección de objetos.
Sintaxis
ULONG WdfCollectionGetCount(
[in] WDFCOLLECTION Collection
);
Parámetros
[in] Collection
Identificador de un objeto de colección.
Valor devuelto
WdfCollectionGetCount devuelve el número de objetos que se encuentran en la colección.
Se produce una comprobación de errores del sistema 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 obtiene el número de objetos de una colección especificada y se usa el número para examinar todos los objetos de la colección.
ULONG count;
count = WdfCollectionGetCount(CollectionHandle);
for (i = 0; i < count; i++) {
ObjectHandle = WdfCollectionGetItem(
CollectionHandle,
i
);
//
// Perform object-specific operations.
//
}
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) |