BdaInitFilter 関数 (bdasup.h)
BdaInitFilter 関数は、フィルター インスタンスに関連付けられている BDA フィルター コンテキストを初期化します。
構文
NTSTATUS BdaInitFilter(
[in] PKSFILTER pKSFilter,
[in] const BDA_FILTER_TEMPLATE *pBdaFilterTemplate
);
パラメーター
[in] pKSFilter
BDA フィルター コンテキストを初期化するフィルターを指します。
[in] pBdaFilterTemplate
BDA デバイスのフィルター テンプレートを記述する BDA_FILTER_TEMPLATE 構造体を指します。 ネットワーク プロバイダーは、初期化されたフィルターのトポロジを決定して構成するために、このBDA_FILTER_TEMPLATE構造で参照される情報を使用します。
戻り値
STATUS_SUCCESSまたは適切なエラー コードを返します。
備考
BDA ミニドライバーは、BdaInitFilter 関数を呼び出して、特定の BDA フィルター テンプレートと、BdaCreateFilterFactory 関数の呼び出しによって以前に作成されたフィルター ファクトリを使用してフィルターのインスタンスを初期化します。 BDA ミニドライバーは、その後、BdaCreatePin など、他の BDA サポート関数呼び出しでこのフィルター インスタンスを使用できます。
BDA ミニドライバーが BdaInitFilter 呼び出すと、BDA サポート ドライバー (Bdasup.sys) によって独自の BDA フィルター コンテキストが作成されます。 この BDA フィルター コンテキストは、BDA ミニドライバーには表示されません。 ただし、必要に応じて、BDA サポート ドライバーはこの BDA フィルター コンテキストにアクセスできます。 BDA サポート ドライバーは、関連付けられた KSFILTER オブジェクトのオブジェクト バッグに、この BDA フィルター コンテキストへのポインターを追加します。 関連付けられている KSFILTER オブジェクトが破棄されると、AVStream は、BDA サポート ドライバーがオブジェクト バッグからこの BDA フィルター コンテキストを削除することを要求します。 このようにして、BDA サポート ドライバーは、BDA ミニドライバーによる介入を必要とせずに、この BDA フィルター コンテキストを破棄できます。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Microsoft Windows XP 以降のオペレーティング システムで使用できます。 このルーチンは、Microsoft DirectX 9.0 以降がそのプラットフォームにインストールされている場合にのみ、Windows 2000 プラットフォームで使用できます。 |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | bdasup.h (Bdasup.h を含む) |
| ライブラリ | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |
関連項目
KSFILTER を する