Función WdfCollectionRemoveItem (wdfcollection.h)
[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
Ninguno
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 Framework Object Collections
Ejemplos
Para obtener un ejemplo de código que usa WdfCollectionRemoveItem, vea WdfCollectionGetFirstItem.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| versión mínima de UMDF | 2.0 |
| encabezado de | wdfcollection.h (incluya Wdf.h) |
| biblioteca de | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| irQL | <= DISPATCH_LEVEL |
| reglas de cumplimiento de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |