Функция WdfCollectionGetLastItem (wdfcollection.h)
[Применимо к KMDF и UMDF]
Метод WdfCollectionGetLastItem возвращает дескриптор последнему объекту, который находится в коллекции объектов.
Синтаксис
WDFOBJECT WdfCollectionGetLastItem(
[in] WDFCOLLECTION Collection
);
Параметры
[in] Collection
Дескриптор объекта коллекции.
Возвращаемое значение
WdfCollectionGetLastItem возвращает дескриптор объекту, который в настоящее время находится в конце списка объектов указанной коллекции, или NULL, если список пуст.
Ошибка возникает, если драйвер предоставляет недопустимый дескриптор объекта.
Замечания
Дополнительные сведения о коллекциях объектов см. в коллекциях объектов Framework.
Примеры
В следующем примере кода получается дескриптор последнего объекта, который находится в коллекции объектов.
WDFOBJECT lastItem;
lastItem = WdfCollectionGetLastItem(hCollection);
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Всеобщий |
| минимальная версия 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) |