KsGetNextSibling 函数 (ks.h)
KsGetNextSibling 函数返回给定对象的下一个同级。
语法
KSDDKAPI PVOID KsGetNextSibling(
[in] PVOID Object
);
参数
[in] Object
要为其查找下一个同级的对象。
返回值
KsGetNextSibling 返回 Object 的下一个同级对象。 如果不存在此类同级对象,则返回 NULL。
注解
如果 Object 是一个筛选器工厂, 则 KsGetNextSibling 返回属于父设备的下一个筛选器工厂,依此而论。 调用方必须在 PVOID 之间执行适当的类型广播。
只有在保留相应的互斥体时,才保证对象层次结构稳定,在本例中为设备互斥体。 有关详细信息,请参阅 AVStream 概述 和 AVStream 中的互斥体。
微型驱动程序很少直接调用 KsGetNextSibling 。 有许多函数是对 KsGetNextSibling 的内联调用并执行类型转换: KsFilterFactoryGetNextSiblingFilterFactory、 KsFilterGetNextSiblingFilter 和 KsPinGetNextSiblingPin。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 Microsoft Windows XP 及更高版本的操作系统以及 DirectX 8.0 及更高版本的 DirectX 中可用。 |
目标平台 | 通用 |
标头 | ks.h (包括 Ks.h) |
Library | Ks.lib |
IRQL | PASSIVE_LEVEL |