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.

Valor de retorno

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

Uma verificação de bugs do sistema ocorre se o driver fornece um identificador de objeto inválido.

Observações

Para obter mais informações sobre coleções de objetos, consulte Coleções de Objetos da Estrutura.

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

Consulte também

WdfCollectionGetItem