Функция KsFilterGetChildPinCount (ks.h)
Функция KsFilterGetChildPinCountвозвращает количество контактов заданного типа, которые в данный момент создаются в заданном фильтре.
Синтаксис
KSDDKAPI ULONG KsFilterGetChildPinCount(
[in] PKSFILTER Filter,
[in] ULONG PinId
);
Параметры
[in] Filter
Указатель на структуру KSFILTER , для которой необходимо найти количество экземпляров контактов типа PinID.
[in] PinId
Тип закрепления, для которого необходимо найти количество экземпляров контактов. PinID — это индекс массива дескрипторов контактов для фильтра, которому принадлежит закрепление.
Возвращаемое значение
KsFilterGetChildPinCount возвращает количество контактов типа PinID , которые в настоящее время создаются в Фильтре. Если таких контактов не существует или pinID выходит за пределы диапазона, возвращается ноль.
Комментарии
Счетчик, возвращаемый этим вызовом, гарантированно будет правильным, только если функция вызывается при удержании мьютекса элемента управления фильтром. Счетчик остается правильным после вызова, пока этот мьютекс продолжает храниться. Как только мьютекс освобождается, другие контакты можно добавить или удалить, тем самым изменив фактическое число контактов.
Дополнительные сведения см. в разделе Мьютексы в AVStream.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в операционных системах Microsoft Windows XP и более поздних версиях, а также DirectX 8.0 и более поздних версиях. |
| Целевая платформа | Универсальное |
| Верхняя часть | ks.h (включая Ks.h) |
| Библиотека | Ks.lib |
| IRQL | PASSIVE_LEVEL |