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


Функция 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)

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

WdfCollectionGetItem