Função WdfCollectionGetLastItem (wdfcollection.h)
[Aplica-se a KMDF e UMDF]
O método WdfCollectionGetLastItem retorna um identificador para o último objeto que está em uma coleção de objetos.
Sintaxe
WDFOBJECT WdfCollectionGetLastItem(
[in] WDFCOLLECTION Collection
);
Parâmetros
[in] Collection
Um identificador para um objeto de coleção.
Valor de retorno
WdfCollectionGetLastItem retorna um identificador para o objeto que está atualmente no final da lista de objetos da coleção especificada ou null se a lista estiver vazia.
Uma verificação de bug 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 um identificador para o último objeto que está em uma coleção de objetos.
WDFOBJECT lastItem;
lastItem = WdfCollectionGetLastItem(hCollection);
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) |