StorPortGetSystemPortNumber 函数 (storport.h)

  • 项目

StorPortGetSystemNumber 例程检索系统为存储适配器分配的端口号。

语法

ULONG StorPortGetSystemPortNumber(
  [in]      PVOID         HwDeviceExtension,
  [in, out] PSTOR_ADDRESS Address
);

参数

[in] HwDeviceExtension

指向主机总线适配器的硬件设备扩展的指针 (HBA) 。

[in, out] Address

指向格式化为 STOR_ADDR_BTL8 的存储地址结构的指针。 返回时，此结构的 Port 成员将包含分配给适配器的端口值。

返回值

StorPortGetSystemPortNumber 返回以下状态代码之一：

返回代码 说明
STOR_STATUS_INVALID_DEVICE_STATE
 尚未将端口号值分配给存储适配器。
STOR_STATUS_SUCCESS
 指示已成功返回存储适配器的端口号。
STOR_STATUS_INVALID_PARAMETER
 HwDeviceExtension 为 NULL。

-或-

地址的 Type 成员不是STOR_ADDRESS_TYPE_BTL8。

注解

地址指向的地址结构被分配并格式化为STOR_ADDR_BTL8。 Address 的 Type 成员必须设置为 STOR_ADDRESS_TYPE_BTL8 并且 Length 成员 Address 必须大于或等于 STOR_ADDR_BTL8_ADDRESS_LENGTH。

要求

要求 值
最低受支持的客户端 从 Windows 8 开始可用。
目标平台 通用
标头 storport.h

另请参阅

STOR_ADDRESS

STOR_ADDR_BTL8