Функция WdfCollectionGetCount (wdfcollection.h)
[Применимо к KMDF и UMDF]
Метод WdfCollectionGetCount возвращает количество объектов, которые в настоящее время находятся в коллекции объектов.
Синтаксис
ULONG WdfCollectionGetCount(
[in] WDFCOLLECTION Collection
);
Параметры
[in] Collection
Дескриптор объекта коллекции.
Возвращаемое значение
WdfCollectionGetCount возвращает количество объектов, которые находятся в коллекции.
Системная ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.
Комментарии
Дополнительные сведения о коллекциях объектов см. в разделе Коллекции объектов платформы.
Примеры
Следующий пример кода получает количество объектов в указанной коллекции и использует его для проверки всех объектов в коллекции.
ULONG count;
count = WdfCollectionGetCount(CollectionHandle);
for (i = 0; i < count; i++) {
ObjectHandle = WdfCollectionGetItem(
CollectionHandle,
i
);
//
// Perform object-specific operations.
//
}
Требования
Требование | Значение |
---|---|
Целевая платформа | Универсальное |
Минимальная версия 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) |