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.

Comentarios

Para obtener más información sobre las colecciones de objetos, vea Colecciones de objetos framework.

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	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1.0
Versión mínima de UMDF	2.0
Encabezado	wdfcollection.h (incluir Wdf.h)
Library	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
Reglas de cumplimiento de DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte también

WdfCollectionGetItem