Função WdfCollectionRemove (wdfcollection.h)

[Aplica-se a KMDF e UMDF]

O método WdfCollectionRemove remove um objeto de uma coleção de objetos especificada.

Sintaxe

void WdfCollectionRemove(
  [in] WDFCOLLECTION Collection,
  [in] WDFOBJECT     Item
);

Parâmetros

[in] Collection

Um identificador para um objeto de coleção.

[in] Item

Um identificador para o objeto de estrutura que será removido da coleção.

Retornar valor

Nenhum

Comentários

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

Quando WdfCollectionRemove 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

O exemplo de código a seguir remove um objeto especificado de uma coleção de objetos especificada.

WdfCollectionRemove(
                    hCollection,
                    hObject
                    );

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

WdfCollectionRemoveItem