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