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 |
另请参阅
KsFilterFactoryGetParentDevice