HW_STATE_CHANGE回调函数 (storport.h)

  • 项目

处理 来自 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

调用 StorPortStateChangeDetected 时由微型端口作为 HwStateChangeContext 提供的上下文。

[in] AddressType

Address 中地址的类型。

[in] Address

指向已处理其状态更改的实体 的STOR_ADDRESS 结构的指针。

[in] Status

状态更改通知的处理状态。

返回值

无

备注

使用 Storport 获取的 StartIo 锁调用 HwStorStateChange 。

此回调使微型端口能够在添加或删除硬件后执行所需的任何其他处理。 如果在 HBA 端口或总线上发生硬件更改，微型端口可以调用 StorPortStateChangeDetected ，以向系统发出事件警报。

如果“状态”<的值为“0x80000000”，则表示通知处理成功。 否则，通知过程将失败。

名称 HwStorStateChange 只是 StorPortStateChangeDetected 的 HwStateChange 参数指向的微型端口函数的占位符。 此例程的实际原型在 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