KsGetParent 函数获取给定对象的父对象。
语法
KSDDKAPI PVOID KsGetParent(
[in] PVOID Object
);
参数
[in] Object
指向要为其查找父对象的 AVStream 对象的指针。 必须是指向以下类型之一的指针:KSDEVICE、KSFILTERFACTORY、KSFILTER或 KSPIN。 调用方必须将对象手动类型化为 PVOID。
返回值
KsGetParent 将 Object 的父级作为 PVOID 返回。 调用方必须手动将此返回值强制转换为 对象 的父级类型。
言论
有关 AVStream 父/子关系的图形表示形式,请参阅 AVStream 对象层次结构中的关系图。
对象层次结构仅在保留适当的互斥体时保证稳定,在本例中为设备互斥体。 有关详细信息,请参阅 AVStream 中的互斥体。
微型驱动程序很少直接使用此函数。 KsGetParent 的调用方必须手动对 PVOID 执行类型转换。 有许多内联版本为你执行强制转换:KsFilterFactoryGetParentDevice、KsFilterGetParentFilterFactory,以及 KsPinGetParentFilter。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Microsoft Windows XP 及更高版本的作系统以及 DirectX 8.0 及更高版本的 DirectX 版本中提供。 |
目标平台 | 普遍 |
标头 | ks.h (包括 Ks.h) |
库 | Ks.lib |
IRQL | PASSIVE_LEVEL |
另请参阅
KsFilterFactoryGetParentDevice