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 中的 Mutexes。

微型驱动程序很少直接使用此函数。 KsGetParent 的调用方必须手动执行到 PVOID 和从 PVOID 进行类型广播。有许多内联版本会为你执行强制转换： KsFilterFactoryGetParentDevice、 KsFilterGetParentFilterFactory 和 KsPinGetParentFilter。

要求	值
最低受支持的客户端	在 Microsoft Windows XP 及更高版本的操作系统以及 DirectX 8.0 及更高版本的 DirectX 中可用。
目标平台	通用
标头	ks.h (包括 Ks.h)
Library	Ks.lib
IRQL	PASSIVE_LEVEL