次の方法で共有


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_ITEMFlags メンバーの表を参照してください。

戻り値

KsFilterFactoryAddCreateItem は、新しい作成項目の追加の試行の成功または失敗を返します。

備考

通常、フィルター記述子で指定された参照 GUID を使用する 1 つの作成項目のみがフィルター ファクトリに追加されます。 この関数を使用すると、呼び出し元は、指定されたフィルター ファクトリに関連付けられている作成項目を追加できます。

詳細については、「AVStream ミニドライバーの初期化」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Microsoft Windows XP 以降のオペレーティング システムと DirectX 8.0 以降の DirectX バージョンで使用できます。
ターゲット プラットフォーム 万国
ヘッダー ks.h (Ks.h を含む)
ライブラリ Ks.lib

関連項目

KSOBJECT_CREATE_ITEM

KsAddObjectCreateItemToDeviceHeader

KsAddObjectCreateItemToObjectHeader

KsAllocateObjectCreateItem

KsFreeObjectCreateItem

KsQueryObjectCreateItem