Compartir a través de


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)

Consulte también

WdfCollectionGetFirstItem

WdfCollectionGetLastItem