Compartilhar via


Função WdfCollectionRemoveItem (wdfcollection.h)

[Aplica-se a KMDF e UMDF]

O método WdfCollectionRemoveItem remove um objeto especificado de uma coleção de objetos, com base em um valor de índice especificado.

Sintaxe

void WdfCollectionRemoveItem(
  [in] WDFCOLLECTION Collection,
  [in] ULONG         Index
);

Parâmetros

[in] Collection

Um identificador para um objeto de coleção.

[in] Index

Um índice baseado em zero que identifica o objeto a ser removido.

Retornar valor

Nenhum

Comentários

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

Os valores de índice representam a ordem na qual os objetos são adicionados a uma coleção. Um valor de índice igual a zero representa o primeiro objeto que foi adicionado à coleção, um valor de índice de um representa o segundo objeto e assim por diante.

Quando WdfCollectionRemoveItem remove um objeto de uma coleção, ele diminui a contagem de referência do objeto.

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 WdfCollectionRemoveItem, consulte WdfCollectionGetFirstItem.

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 (include Wdf.h)
Biblioteca Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
Regras de conformidade da DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Confira também

WdfCollectionRemove