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