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


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

Функция KsGetFirstChild возвращает первый дочерний объект AVStream объекта.

Синтаксис

KSDDKAPI PVOID KsGetFirstChild(
  [in] PVOID Object
);

Параметры

[in] Object

Объект, для которого необходимо найти первый дочерний объект AVStream.

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

KsGetFirstChild возвращает первый дочерний объект AVStream объекта Object. Если такого дочернего объекта не существует, возвращается значение NULL.

Комментарии

Иерархическую организацию объектов AVStream см. в разделе Иерархия объектов AVStream.

Мини-накопители редко вызывают эту функцию напрямую. Те, которые делают, должны вручную выполнять отправку типов в PVOID и из нее. Существует ряд функций, которые являются встроенными вызовами KsGetFirstChild и выполняют за вас трансляции типов: KsDeviceGetFirstChildFilterFactory и KsFilterFactoryGetFirstChildFilter. Обратите внимание, что иерархия объектов гарантируется только при сохранении соответствующего мьютекса, в данном случае мьютекса устройства. Дополнительные сведения см. в разделе Мьютексы в AVStream.

Требования

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

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

KsDeviceGetFirstChildFilterFactory

KsFilterFactoryGetFirstChildFilter

KsFilterGetFirstChildPin

KsGetParent