Função WdfCollectionGetCount (wdfcollection.h)

[Aplica-se a KMDF e UMDF]

O método WdfCollectionGetCount retorna o número de objetos que estão atualmente em uma coleção de objetos.

Sintaxe

ULONG WdfCollectionGetCount(
  [in] WDFCOLLECTION Collection
);

Parâmetros

[in] Collection

Um identificador para um objeto de coleção.

Retornar valor

WdfCollectionGetCount retorna o número de objetos que estão na coleção.

Um bug do sistema marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Comentários

Para obter mais informações sobre coleções de objetos, consulte Coleções de objetos framework.

Exemplos

O exemplo de código a seguir obtém o número de objetos em uma coleção especificada e usa o número para examinar todos os objetos da coleção.

ULONG count;

count = WdfCollectionGetCount(CollectionHandle);
for (i = 0; i < count; i++) {
    ObjectHandle = WdfCollectionGetItem(
                                        CollectionHandle,
                                        i
                                        );
    // 
    // Perform object-specific operations.
    // 
}

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Versão mínima do UMDF 2,0
Cabeçalho wdfcollection.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
Regras de conformidade de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Confira também

WdfCollectionGetItem