BdaCommitChanges 関数 (bdasup.h)

[アーティクル]
02/22/2024

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