BdaStartChanges 関数 (bdasup.h)
BdaStartChanges 関数は、新しい BDA トポロジの変更の設定を開始します。
構文
NTSTATUS BdaStartChanges(
[in] PIRP pIrp
);
パラメーター
[in] pIrp
変更を開始する要求の IRP をポイントします。 BDA ミニドライバーは、KSMETHOD_BDA_START_CHANGES 要求でこの IRP を受け取ります。
戻り値
STATUS_SUCCESSまたは適切なエラー コードを返します。
備考
BDA ミニドライバーは、BdaStartChanges 関数を呼び出して、ミニドライバーがネットワーク プロバイダーから設定された KSMETHODSETID_BdaChangeSync メソッドの KSMETHOD_BDA_START_CHANGES 要求を受信した後に、新しい BDA トポロジの変更の設定を開始します。 BDA ミニドライバーは、ディスパッチとフィルター自動化のテーブルを定義して、それらのミニドライバーが BdaStartChanges 関数を直接ディスパッチするか、内部メソッド (KStrMethodHandler) を使用してこの要求をインターセプトし、BdaStartChanges 関数を呼び出すようにします。 たとえば、この要求をインターセプトする BDA ミニドライバーは、渡された IRP から BDA フィルターへのポインターを取得し、その後、保留中のフィルター リソースを新しい要件にリセットし、フィルターの変更状態をBDA_CHANGES_COMPLETEに設定できます。 詳細については、「自動化テーブル の定義と BDA フィルター プロパティの変更 の を参照してください。
BdaStartChanges 関数を呼び出すと、以前に要求されたトポロジの変更がまだコミットされていない場合は無視されます。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | bdasup.h (Bdasup.h を含む) |
| ライブラリ | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |