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

Статья
02/26/2024

Обратный вызов, предоставляемый минипортом, который вызывается после уведомления от 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

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

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

None

Remarks

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

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

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

Имя HwStorStateChange — это просто заполнитель для функции miniport, на которую указывает параметр HwStateChangeобъекта StorPortStateChangeDetected. Фактический прототип этой подпрограммы определен в 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 (включая Storport.h)
IRQL	ОТПРАВКИ

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

STOR_ADDRESS

StorPortStateChangeDetected

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