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

Статья
02/07/2025

[Применимо к KMDF и UMDF]

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

Синтаксис

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

Параметры

[in] Collection

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

[in] Index

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

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

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

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

Замечания

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

Дополнительные сведения о коллекциях объектов см. в коллекциях объектов Framework.

Примеры

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

Требования

Требование	Ценность
целевая платформа	Всеобщий
минимальная версия KMDF	1.0
минимальная версия UMDF	2.0
заголовка	wdfcollection.h (include Wdf.h)
библиотеки	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
правил соответствия DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

См. также

WdfCollectionGetFirstItem

WdfCollectionGetLastItem

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