Функция KsGetParent (ks.h)
Функция KsGetParent получает родительский объект заданного объекта.
Синтаксис
KSDDKAPI PVOID KsGetParent(
[in] PVOID Object
);
Параметры
[in] Object
Указатель на объект AVStream, для которого требуется найти родительский объект. Должен быть указателем на один из следующих типов: KSDEVICE, KSFILTERFACTORY, KSFILTER или KSPIN. Вызывающие объекты должны вручную ввести объект в PVOID.
Возвращаемое значение
KsGetParent возвращает родительский объект Object в виде PVOID. Вызывающие объекты должны вручную привести это возвращаемое значение к типу родительского объекта Object .
Комментарии
Графическое представление связей "родители-потомки" AVStream см. на схеме в разделе "Иерархия объектов AVStream".
Иерархия объектов гарантируется стабильной только при удержании соответствующего мьютекса, в данном случае — мьютекса устройства. Дополнительные сведения см. в разделе Мьютексы в AVStream.
Мини-драйверы редко используют эту функцию напрямую. Вызывающие методы KsGetParent должны вручную выполнять передачу типов в PVOID и из нее. Существует несколько встроенных версий, которые выполняют приведение: KsFilterFactoryGetParentDevice, KsFilterGetParentFilterFactory и KsPinGetParentFilter.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Доступно в операционных системах Microsoft Windows XP и более поздних версиях, а также DirectX 8.0 и более поздних версий. |
Целевая платформа | Универсальное |
Верхняя часть | ks.h (включая Ks.h) |
Библиотека | Ks.lib |
IRQL | PASSIVE_LEVEL |
См. также раздел
KsFilterFactoryGetParentDevice