Função WdfCollectionGetCount (wdfcollection.h)

Artigo
02/07/2025

[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

Requisito	Valor
da 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)

Consulte também

WdfCollectionGetItem

Compartilhar via