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

Статья
02/07/2025

Функция KsGetParent получает родительский элемент данного объекта.

Синтаксис

KSDDKAPI PVOID KsGetParent(
  [in] PVOID Object
);

Параметры

[in] Object

Указатель на объект AVStream, для которого нужно найти родительский объект. Должен быть указателем на один из следующих типов: KSDEVICE, KSFILTERFACTORY, KSFILTERили KSPIN. Вызывающие объекты должны вручную вводить объект в PVOID.

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

KsGetParent возвращает родительский элемент объекта в виде PVOID. Вызывающие объекты должны вручную привести это возвращаемое значение к типу родительского элемента Object.

Замечания

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

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

Мини-drivers редко используют эту функцию напрямую. Вызывающие KsGetParent должны вручную выполнять передачи типов в PVOID и из него. Существует ряд встроенных версий, которые делают приведение для вас: KsFilterFactoryGetParentDevice, KsFilterGetParentFilterFactoryи KsPinGetParentFilter.

Требования

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