StorPortValidateRange 函数 (storport.h)

  • 项目

StorPortValidateRange 例程确定指定的 I/O 地址范围是否由另一个适配器使用。 此例程在 Windows NT 4.0 及更高版本的操作系统中已过时。

语法

STORPORT_API BOOLEAN StorPortValidateRange(
  [in] PVOID                 HwDeviceExtension,
  [in] INTERFACE_TYPE        BusType,
       ULONG                 SystemIoBusNumber,
  [in] STOR_PHYSICAL_ADDRESS IoAddress,
  [in] ULONG                 NumberOfBytes,
  [in] BOOLEAN               InIoSpace
);

参数

[in] HwDeviceExtension

指向硬件设备扩展的指针。 这是端口驱动程序代表微型端口驱动程序分配和初始化的每个 HBA 存储区域。 微型端口驱动程序通常在此扩展中存储特定于 HBA 的信息，例如 HBA 的状态和 HBA 的映射访问范围。 此区域在微型端口驱动程序调用 StorPortInitialize 后立即可供微型端口驱动程序使用。 端口驱动程序在移除设备时释放此内存。

[in] BusType

包含类型 为 STORAGE_BUS_TYPE 的值，该值指示总线类型。

SystemIoBusNumber

包含标识系统总线的整数。

[in] IoAddress

包含要验证的地址范围的起始地址。

[in] NumberOfBytes

包含要验证的地址范围的长度（以字节为单位）。

[in] InIoSpace

当 为 TRUE 时，指示地址范围在 I/O 空间中。 如果 为 FALSE，则地址位于内存空间中。

返回值

如果其他驱动程序未声明指定的地址范围，StorPortValidateRange 将返回 TRUE。 如果另一个驱动程序已声明地址范围，则此例程返回 FALSE 。

注解

为了与旧版 Windows 兼容，此例程始终返回 TRUE。

当 Storport 驱动程序调用微型端口的 HwStorFindAdapter 回调例程时，在 PORT_CONFIGURATION_INFORMATION 结构的 AccessRanges 成员中为微型端口驱动程序提供有效的 I/O 范围。

StorPortValidateRange 使用 STOR_PHYSICAL_ADDRESS 来表示相对于总线的地址。

typedef PHYSICAL_ADDRESS STOR_PHYSICAL_ADDRESS, *PSTOR_PHYSICAL_ADDRESS;

STOR_PHYSICAL_ADDRESS类型是与操作系统无关的数据类型，Storport 微型端口驱动程序使用它来表示物理地址或相对于总线的地址。

要求

要求 值
目标平台 通用
标头 storport.h (包括 Storport.h)
Library Storport.lib
DDI 符合性规则 StorPortDeprecated (storport)

另请参阅

ScsiPortValidateRange