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 以降のオペレーティング システムで使用できます。
対象プラットフォーム デスクトップ
Header bdasup.h (Bdasup.h を含む)
Library Bdasup.lib
IRQL PASSIVE_LEVEL

こちらもご覧ください

BDA_FILTER_TEMPLATE

BdaCreateFilterFactoryEx

KSDEVICE

KSFILTERFACTORY

KSFILTER_DESCRIPTOR

KSMETHODSETID_BdaChangeSync

KSMETHODSETID_BdaDeviceConfiguration

KSPROPSETID_BdaTopology