Функция BdaCommitChanges (bdasup.h)

Статья
02/22/2024

Функция BdaCommitChanges фиксирует изменения в топологии BDA, произошедшие с момента последнего вызова функции BdaStartChanges .

Синтаксис

NTSTATUS BdaCommitChanges(
  [in] PIRP pIrp
);

Параметры

[in] pIrp

Указывает на IRP для запроса на фиксацию изменений. Мини-диск BDA получает этот IRP с запросом KSMETHOD_BDA_COMMIT_CHANGES .

Возвращаемое значение

Возвращает STATUS_SUCCESS или соответствующий код ошибки.

Мини-накопитель BDA вызывает функцию BdaCommitChanges для фиксации набора изменений топологии BDA после того, как мини-накопитель получит KSMETHOD_BDA_COMMIT_CHANGES запрос набора метода KSMETHODSETID_BdaChangeSync от поставщика сети. Мини-драйверы BDA определяют таблицы диспетчеризации и автоматизации фильтров, чтобы эти мини-драйверы либо отправляли функцию BdaCommitChanges напрямую, либо перехватывая этот запрос с помощью внутреннего метода (KStrMethodHandler), который затем вызывает функцию BdaCommitChanges . Например, мини-драйверы BDA, перехватывющие этот запрос, могут получить указатель на фильтр BDA из переданного IRP, чтобы они могли:

Задайте новый список ресурсов для фильтра в качестве ожидающего списка ресурсов.
Задайте для фильтра состояние изменения значение BDA_CHANGES_COMPLETE.
Зафиксируйте ресурсы на базовом устройстве.

Дополнительные сведения см. в разделах Определение таблиц автоматизации и Изменение свойств фильтра BDA .

Требования

Требование	Значение
Минимальная версия клиента	Доступно в операционных системах Microsoft Windows XP и более поздних версий.
Целевая платформа	Персональный компьютер
Верхняя часть	bdasup.h (включая Bdasup.h)
Библиотека	Bdasup.lib
IRQL	PASSIVE_LEVEL