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 プラットフォームで使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | bdasup.h (Bdasup.h を含む) |
| Library | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |