BdaCommitChanges 関数 (bdasup.h)
BdaCommitChanges 関数は、BdaStartChanges 関数の最後の呼び出し以降に発生した BDA トポロジへの変更をコミットします。
構文
NTSTATUS BdaCommitChanges(
[in] PIRP pIrp
);
パラメーター
[in] pIrp
変更をコミットする要求の IRP を指します。 BDA ミニドライバーは、 KSMETHOD_BDA_COMMIT_CHANGES 要求でこの IRP を受け取ります。
戻り値
STATUS_SUCCESSまたは適切なエラー コードを返します。
注釈
BDA ミニドライバーは 、BdaCommitChanges 関数を呼び出して、ミニドライバーがネットワーク プロバイダーから設定 されたKSMETHODSETID_BdaChangeSync メソッドのKSMETHOD_BDA_COMMIT_CHANGES要求を受け取った後、 一 連の BDA トポロジの変更をコミットします。 BDA ミニドライバーは、ディスパッチ テーブルとフィルターオートメーション テーブルを定義して、それらのミニドライバーが BdaCommitChanges 関数を直接ディスパッチするか、内部メソッド (KStrMethodHandler) を使用してこの要求をインターセプトし、 BdaCommitChanges 関数を呼び出すようにします。 たとえば、この要求をインターセプトする BDA ミニドライバーは、渡された IRP から BDA フィルターへのポインターを取得して、次のことができるようにします。
フィルターのリソースの新しい一覧を、保留中のリソースの一覧に設定します。
フィルターの変更状態をBDA_CHANGES_COMPLETEに設定します。
基になるデバイス上のリソースをコミットします。
詳細については、 自動化テーブルの定義 と BDA フィルターのプロパティの変更 に関するページを参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Microsoft Windows XP 以降のオペレーティング システムで使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | bdasup.h (Bdasup.h を含む) |
| Library | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |