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
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) |