Función WdfCollectionGetItem (wdfcollection.h)
[Se aplica a KMDF y UMDF]
El método WdfCollectionGetItem devuelve un identificador al objeto contenido en una colección de objetos especificada y asociado a un valor de índice especificado.
Sintaxis
WDFOBJECT WdfCollectionGetItem(
[in] WDFCOLLECTION Collection,
[in] ULONG Index
);
Parámetros
[in] Collection
Identificador de un objeto de colección.
[in] Index
Valor de índice de base cero que identifica un objeto de la colección.
Valor devuelto
WdfCollectionGetItem devuelve un identificador de objeto de marco o NULL si el valor index no es válido.
Se produce una comprobación de errores del sistema si el controlador proporciona un identificador de objeto no válido.
Comentarios
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 de la colección, un valor de índice de uno representa el segundo objeto, etc., como una lista vinculada. Cuando el controlador quita el elemento i de una colección, el elemento i+1 se convierte en el elemento i.
Para obtener más información sobre las colecciones de objetos, vea Colecciones de objetos de marco.
Ejemplos
Para obtener un ejemplo de código que usa WdfCollectionGetItem, vea WdfCollectionGetCount.
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 (incluya 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) |