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 Minidriver。

要求

要求	價值
最低支援的用戶端	Microsoft Windows XP 和更新版本的作系統和 DirectX 8.0 和更新版本的 DirectX 版本中提供。
目標平臺	普遍
標頭	ks.h （包括 Ks.h）
連結庫	Ks.lib