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

Статья
02/07/2025

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

Метод WdfCollectionGetCount возвращает количество объектов, которые в настоящее время находятся в коллекции объектов.

Синтаксис

ULONG WdfCollectionGetCount(
  [in] WDFCOLLECTION Collection
);

Параметры

[in] Collection

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

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

WdfCollectionGetCount возвращает количество объектов, которые находятся в коллекции.

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

Замечания

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

Примеры

В следующем примере кода получается количество объектов в указанной коллекции и используется число для проверки всех объектов в коллекции.

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 (include Wdf.h)
библиотеки	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
правил соответствия DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

См. также

WdfCollectionGetItem

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