KsFilterFactoryAddCreateItem 函数 (ks.h)
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 的 Flags 成员，请参阅表。
返回值
KsFilterFactoryAddCreateItem 返回尝试添加新创建项的成功或失败。
注解
通常，仅为筛选器工厂添加使用筛选器描述符中提供的引用 GUID 的单个创建项。 此函数允许调用方添加与给定筛选器工厂关联的创建项。
有关详细信息，请参阅 初始化 AVStream 微型驱动程序。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 Microsoft Windows XP 及更高版本的操作系统以及 DirectX 8.0 及更高版本的 DirectX 中可用。 |
| 目标平台 | 通用 |
| 标头 | ks.h (包括 Ks.h) |
| Library | Ks.lib |
另请参阅
KsAddObjectCreateItemToDeviceHeader