KsGetParent 函数 (ks.h)

KsGetParent 函数获取给定对象的父对象。

语法

KSDDKAPI PVOID KsGetParent(
  [in] PVOID Object
);

参数

[in] Object

指向要为其查找父对象的 AVStream 对象的指针。 必须是指向以下类型之一的指针:KSDEVICEKSFILTERFACTORYKSFILTERKSPIN。 调用方必须将对象手动类型化为 PVOID。

返回值

KsGetParentObject 的父级作为 PVOID 返回。 调用方必须手动将此返回值强制转换为 对象 的父级类型。

言论

有关 AVStream 父/子关系的图形表示形式,请参阅 AVStream 对象层次结构中的关系图。

对象层次结构仅在保留适当的互斥体时保证稳定,在本例中为设备互斥体。 有关详细信息,请参阅 AVStream 中的互斥体。

微型驱动程序很少直接使用此函数。 KsGetParent 的调用方必须手动对 PVOID 执行类型转换。 有许多内联版本为你执行强制转换:KsFilterFactoryGetParentDeviceKsFilterGetParentFilterFactory,以及 KsPinGetParentFilter

要求

要求 价值
最低支持的客户端 Microsoft Windows XP 及更高版本的作系统以及 DirectX 8.0 及更高版本的 DirectX 版本中提供。
目标平台 普遍
标头 ks.h (包括 Ks.h)
Ks.lib
IRQL PASSIVE_LEVEL

另请参阅

KSDEVICE

KSFILTER

KSFILTERFACTORY

KSPIN

KsFilterFactoryGetParentDevice

KsFilterGetParentFilterFactory

KsPinGetParentFilter