BdaCreateFilterFactoryEx 関数 (bdasup.h)
BdaCreateFilterFactoryEx 関数は、指定したフィルター記述子をフィルター ファクトリとして指定したデバイスに追加し、フィルター ファクトリを指定された BDA テンプレート トポロジに関連付けます。
構文
NTSTATUS BdaCreateFilterFactoryEx(
[in] PKSDEVICE pKSDevice,
[in] const KSFILTER_DESCRIPTOR *pFilterDescriptor,
[in] const BDA_FILTER_TEMPLATE *pBdaFilterTemplate,
[out, optional] PKSFILTERFACTORY *ppKSFilterFactory
);
パラメーター
[in] pKSDevice
関連付けられた BDA テンプレート トポロジを使用してフィルター ファクトリを追加する BDA デバイスを指します。
[in] pFilterDescriptor
BDA デバイスのフィルターを記述する KSFILTER_DESCRIPTOR 構造体を指します。 フィルターが最初に初期化されるときに、すべてのテンプレートピンとノードタイプがピンファクトリおよびノードファクトリとして公開されるわけではないことに注意してください。
[in] pBdaFilterTemplate
BDA テンプレート トポロジを記述する BDA_FILTER_TEMPLATE 構造を指します。
[out, optional] ppKSFilterFactory
新しく作成されたフィルター ファクトリの KSFILTERFACTORY 構造体へのポインターを受け取るバッファーを指します。
戻り値
STATUS_SUCCESSまたは適切なエラー コードを返します。
注釈
BDA ミニドライバーは 、BdaCreateFilterFactoryEx 関数を呼び出して、関連付けられた BDA テンプレート トポロジを含むフィルター ファクトリをデバイスに追加し、トポロジのすべての静的テンプレート構造を BDA サポート ライブラリ (BdaSup.sys) に登録します。 BDA サポート ライブラリでは、次のメソッドとプロパティの呼び出しを処理できます。
BDA ミニドライバーは、新しく作成された KSFILTERFACTORY へのポインターが必要な場合は常に 、BdaCreateFilterFactory 関数ではなく BdaCreateFilterFactoryEx を呼び出します。 BdaCreateFilterFactory 関数はフィルター ファクトリも作成しますが、呼び出し元には返しません。 ミニドライバーが KSFILTERFACTORY を編集するために _KsEdit 関数を呼び出す必要がある場合、BDA ミニドライバーは新しく作成された KSFILTERFACTORY へのポインターを必要とします。要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Microsoft Windows XP 以降のオペレーティング システムで使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | bdasup.h (Bdasup.h を含む) |
| Library | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |