Función WdfCollectionRemoveItem (wdfcollection.h)

  • Artículo

[Se aplica a KMDF y UMDF]

El método WdfCollectionRemoveItem quita un objeto especificado de una colección de objetos, basándose en un valor de índice especificado.

Sintaxis

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

Parámetros

[in] Collection

Identificador de un objeto de colección.

[in] Index

Índice de base cero que identifica el objeto que se va a quitar.

Valor devuelto

None

Observaciones

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Los valores de índice representan el orden en el que se agregan objetos a una colección. Un valor de índice de cero representa el primer objeto que se agregó a la colección, un valor de índice de uno representa el segundo objeto, etc.

Cuando WdfCollectionRemoveItem quita un objeto de una colección, disminuye el recuento de referencias del objeto.

Para obtener más información sobre las colecciones de objetos, vea Colecciones de objetos framework.

Ejemplos

Para obtener un ejemplo de código que usa WdfCollectionRemoveItem, vea WdfCollectionGetFirstItem.

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Versión mínima de UMDF 2.0
Encabezado wdfcollection.h (incluir Wdf.h)
Library Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
Reglas de cumplimiento de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte también

WdfCollectionRemove