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

Функция KsDeviceGetFirstChildFilterFactory возвращает первую фабрику дочерних фильтров, принадлежащая данному устройству AVStream.

Синтаксис

PKSFILTERFACTORY KsDeviceGetFirstChildFilterFactory(
  [in] PKSDEVICE Device
);

Параметры

[in] Device

Указатель на структуру KSDEVICE, представляющую устройство AVStream, для которого нужно найти первую дочернюю фабрику фильтров.

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

Возвращает указатель на структуру KSFILTERFACTORY , представляющую первую дочернюю фабрику фильтров устройства. Если на устройстве нет зарегистрированных фабрик фильтров, возвращается значение NULL .

Комментарии

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

Графическое представление связей между родительскими и дочерними элементами AVStream см. на схеме в разделе Иерархия объектов AVStream.

Требования

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

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

KSDEVICE

KSFILTERFACTORY

KsFilterFactoryGetNextSiblingFilterFactory

KsGetFirstChild