KsFilterFactoryAddCreateItem 函数（ks.h）

项目
02/07/2025

KsFilterFactoryAddCreateItem 函数为指定的筛选器工厂添加新的创建项。

语法

KSDDKAPI NTSTATUS KsFilterFactoryAddCreateItem(
  [in]           PKSFILTERFACTORY     FilterFactory,
  [in]           PWSTR                RefString,
  [in, optional] PSECURITY_DESCRIPTOR SecurityDescriptor,
  [in]           ULONG                CreateItemFlags
);

参数

[in] FilterFactory

指向 KSFILTERFACTORY 结构的指针，该结构表示要向其添加新创建项的筛选器工厂。

[in] RefString

指向标识创建项的 Unicode 文本字符串的指针。

[in, optional] SecurityDescriptor

此参数（可选）包含指向此类型对象的SECURITY_DESCRIPTOR结构的指针。有关此结构的信息，请参阅 Microsoft Windows SDK。有关相关信息，请参阅 KSOBJECT_CREATE_ITEM。如果 NULL，则不分配描述符。

[in] CreateItemFlags

请参阅 KSOBJECT_CREATE_ITEM标志成员的表。

返回值

KsFilterFactoryAddCreateItem 返回尝试添加新创建项的成功或失败。

言论

通常，仅为筛选器工厂添加使用筛选器描述符中提供的引用 GUID 的单个创建项。此函数允许调用方添加与给定筛选器工厂关联的创建项。

有关详细信息，请参阅初始化 AVStream 微型驱动程序。

要求

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