Função WdfCollectionGetItem (wdfcollection.h)

  • Artigo

[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.

Retornar valor

WdfCollectionGetItem retornará um identificador de objeto de estrutura ou NULL se o valor index for inválido.

Um bug do sistema marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Comentários

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 na 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 se torna o item i.

Para obter mais informações sobre coleções de objetos, consulte Coleções de objetos framework.

Exemplos

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

Requisitos

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

Confira também

WdfCollectionGetFirstItem

WdfCollectionGetLastItem