функция обратного вызова HW_STATE_CHANGE (storport.h)

Статья
02/07/2025

Обратный вызов с минипортом, который вызывается после обработки уведомления от StorPortStateChangeDetected.

Синтаксис

HW_STATE_CHANGE HwStateChange;

void HwStateChange(
                 PVOID HwDeviceExtension,
  [in, optional] PVOID Context,
  [in]           SHORT AddressType,
  [in]           PVOID Address,
  [in]           ULONG Status
)
{...}

Параметры

HwDeviceExtension

[in] Указатель на область хранения мини-порта для каждого HBA.

[in, optional] Context

Контекст, предоставленный как HwStateChangeContext минипортом в вызове StorPortStateChangeDetected.

[in] AddressType

Тип адреса в адресе.

[in] Address

Указатель на структуру STOR_ADDRESS для сущности, состояние которой было обработано.

[in] Status

Состояние обработки уведомления об изменении состояния.

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

Никакой

Замечания

HwStorStateChange вызывается с блокировкой StartIo, полученной Storport.

Этот обратный вызов позволяет минипортам выполнять любую дополнительную обработку, необходимую после добавления оборудования или удаления. Если на порту или шине HBA происходит изменение оборудования, минипорт может вызвать StorPortStateChangeDetected, чтобы предупредить систему события.

Если значение состояния< 0x80000000, обработка уведомлений прошла успешно. В противном случае процесс уведомления завершился ошибкой.

Имя HwStorStateChange — это просто заполнитель для функции минипорта, на которую указывает параметр HwStateChangeChangeStorPortStateChangeDetected. Фактический прототип этой подпрограммы определен в Storport.h следующим образом:

typedef
VOID
HW_STATE_CHANGE (
    _In_ PVOID HwDeviceExtension,
    _In_opt_ PVOID Context,
    _In_ SHORT AddressType,
    _In_ PVOID Address,
    _In_ ULONG Status
    );

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows 8 и более поздних версиях Windows.
целевая платформа	Всеобщий
заголовка	storport.h (include Storport.h)
IRQL	ОТПРАВКА

См. также

STOR_ADDRESS

StorPortStateChangeDetected

Поделиться через