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

Функция BdaGetChangeState возвращает текущее состояние изменения топологии BDA.

Синтаксис

NTSTATUS BdaGetChangeState(
  [in]            PIRP              pIrp,
  [out, optional] PBDA_CHANGE_STATE pChangeState
);

Параметры

[in] pIrp

Указывает на IRP для запроса на получение текущего состояния изменения. Мини-накопитель BDA получает этот IRP с запросом KSMETHOD_BDA_GET_CHANGE_STATE .

[out, optional] pChangeState

Указывает на переменную, которая получает текущее состояние изменения топологии BDA. Состояние изменения BDA может быть одним из следующих значений из перечисленного типа BDA_CHANGE_STATE :

Значение Описание
BDA_CHANGES_COMPLETE Изменения топологии BDA завершены.
BDA_CHANGES_PENDING Изменения топологии BDA ожидаются.

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

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

Комментарии

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

  • Не только проверка для ожидающих изменений топологии, но и для ожидающих изменений в фильтре.

  • Возвращает текущее состояние изменения как для топологии BDA, так и для фильтра BDA.

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

Требования

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

См. также раздел

BDA_CHANGE_STATE

KSMETHODSETID_BdaChangeSync

KSMETHOD_BDA_GET_CHANGE_STATE

KStrMethodHandler