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

Статья
02/26/2024

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

Синтаксис

KSDDKAPI PVOID KsGetParent(
  [in] PVOID Object
);

Параметры

[in] Object

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

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

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

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

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

Требования

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