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

[Применимо к 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.
    // 
}

Требования

См. также

WdfCollectionGetItem