Função WdfCollectionGetItem (wdfcollection.h)

Artigo
07/02/2025

[Aplica-se a KMDF e UMDF]

O método WdfCollectionGetItem retorna um identificador para o objeto contido em uma coleção de objetos especificada e associado a um valor de índice especificado.

Sintaxe

WDFOBJECT WdfCollectionGetItem(
  [in] WDFCOLLECTION Collection,
  [in] ULONG         Index
);

Parâmetros

[in] Collection

Um identificador para um objeto de coleção.

[in] Index

Um valor de índice baseado em zero que identifica um objeto na coleção.

Valor de retorno

WdfCollectionGetItem retorna um identificador de objeto da estrutura ou NULL se o valor Index for inválido.

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

Observações

Os valores de índice representam a ordem na qual os objetos são adicionados a uma coleção. Um valor de índice zero representa o primeiro objeto da coleção, um valor de índice de um representa o segundo objeto e assim por diante, como uma lista vinculada. Quando o driver remove o item i de uma coleção, o item i+1 torna-se item i.

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

Exemplos

Para obter um exemplo de código que usa WdfCollectionGetItem, consulte WdfCollectionGetCount.

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

WdfCollectionGetFirstItem

WdfCollectionGetLastItem

Compartilhar via