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) |