Функция KsFilterFactoryGetFirstChildFilter (ks.h)

Функция KsFilterFactoryGetFirstChildFilter возвращает первый экземпляр фильтра, созданного FilterFactory.

Синтаксис

PKSFILTER KsFilterFactoryGetFirstChildFilter(
  [in] PKSFILTERFACTORY FilterFactory
);

Параметры

[in] FilterFactory

Указатель на структуру KSFILTERFACTORY , для которой необходимо найти первый экземпляр дочернего фильтра.

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

KsFilterFactoryGetFirstChildFilter возвращает указатель на первый экземпляр структуры KSFILTER , созданной FilterFactory. Если с помощью FilterFactory нет созданных экземпляров фильтров, возвращается значение NULL .

Комментарии

Этот вызов является встроенным вызовом функции KsGetFirstChild. Обратите внимание, что иерархия объектов гарантированно будет стабильной только при сохранении соответствующего мьютекса, в данном случае мьютекса устройства. Дополнительные сведения см. в разделе Мьютексы в AVStream.

Требования

Требование Значение
Минимальная версия клиента Доступно в операционных системах Microsoft Windows XP и более поздних версиях, а также DirectX 8.0 и более поздних версиях.
Целевая платформа Персональный компьютер
Верхняя часть ks.h (включая Ks.h)
IRQL PASSIVE_LEVEL

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

KSFILTER

KSFILTERFACTORY

KsFilterGetNextSiblingFilter

KsGetFirstChild