Функция WdfCollectionGetItem (wdfcollection.h)

Статья
02/26/2024

[Относится к KMDF и UMDF]

Метод WdfCollectionGetItem возвращает дескриптор объекту, который содержится в указанной коллекции объектов и связан с заданным значением индекса.

Синтаксис

WDFOBJECT WdfCollectionGetItem(
  [in] WDFCOLLECTION Collection,
  [in] ULONG         Index
);

Параметры

[in] Collection

Дескриптор объекта коллекции.

[in] Index

Отсчитываемое от нуля значение индекса, идентифицирующее объект в коллекции.

Возвращаемое значение

WdfCollectionGetItem возвращает дескриптор объекта платформы или значение NULL , если значение Индекса недопустимо.

Системная ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Значения индекса представляют порядок добавления объектов в коллекцию. Нулевое значение индекса представляет первый объект в коллекции, значение индекса — второй объект и т. д., как связанный список. Когда драйвер удаляет элемент i из коллекции, элемент i+1 становится элементом i.

Дополнительные сведения о коллекциях объектов см. в разделе Коллекции объектов платформы.

Примеры

Пример кода, в котором используется WdfCollectionGetItem, см. в разделе WdfCollectionGetCount.

Требования

Требование	Значение
Целевая платформа	Универсальное
Минимальная версия KMDF	1,0
Минимальная версия UMDF	2,0
Верхняя часть	wdfcollection.h (включая Wdf.h)
Библиотека	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
Правила соответствия DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

См. также раздел

WdfCollectionGetFirstItem

WdfCollectionGetLastItem

Поделиться через