Функция 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