次の方法で共有


BdaCreateFilterFactory 関数 (bdasup.h)

BdaCreateFilterFactory 関数は、指定したフィルター記述子をフィルター ファクトリとして指定されたデバイスに追加し、フィルター ファクトリを指定された BDA テンプレート トポロジに関連付けます。

構文

NTSTATUS BdaCreateFilterFactory(
  [in] PKSDEVICE                 pKSDevice,
  [in] const KSFILTER_DESCRIPTOR *pFilterDescriptor,
  [in] const BDA_FILTER_TEMPLATE *pBdaFilterTemplate
);

パラメーター

[in] pKSDevice

関連付けられた BDA テンプレート トポロジでフィルター ファクトリを追加する BDA デバイスを指します。

[in] pFilterDescriptor

BDA デバイスのフィルターを記述する KSFILTER_DESCRIPTOR 構造体を指します。 フィルターが最初に初期化されるときに、すべてのテンプレートピンとノードタイプがピンファクトリおよびノードファクトリとして公開されるわけではないことに注意してください。

[in] pBdaFilterTemplate

BDA テンプレート トポロジを記述する BDA_FILTER_TEMPLATE 構造を指します。

戻り値

STATUS_SUCCESSまたは適切なエラー コードを返します。

備考

BDA ミニドライバーは、BdaCreateFilterFactory 関数を呼び出して、関連付けられた BDA テンプレート トポロジを持つフィルター ファクトリをデバイスに追加し、トポロジのすべての静的テンプレート構造を BDA サポート ライブラリ (BdaSup.sys) に登録します。 BDA サポート ライブラリでは、次のメソッドとプロパティの呼び出しを処理できます。

BDA ミニドライバーが新しく作成されたフィルター ファクトリ (KSFILTERFACTORY) へのポインターを必要とする場合、ミニドライバーは代わりに BdaCreateFilterFactoryEx 関数を呼び出す必要があります。

必要条件

要件 価値
サポートされる最小クライアント Microsoft Windows XP 以降のオペレーティング システムで使用できます。
ターゲット プラットフォーム デスクトップ
ヘッダー bdasup.h (Bdasup.h を含む)
ライブラリ Bdasup.lib
IRQL PASSIVE_LEVEL

関連項目

BDA_FILTER_TEMPLATE

BdaCreateFilterFactoryEx

KSDEVICE

KSFILTERFACTORY

KSFILTER_DESCRIPTOR

KSMETHODSETID_BdaChangeSync

KSMETHODSETID_BdaDeviceConfiguration

KSPROPSETID_BdaTopology