MSiSCSI_HBAInformation结构(iscsimgt.h)
存储微型端口驱动程序使用MSiSCSI_HBAInformation结构来报告它们管理给 iSCSI 发起程序服务的主总线适配器(HBA)的相关信息。
语法
typedef struct _MSiSCSI_HBAInformation {
ULONGLONG UniqueAdapterId;
BOOLEAN IntegratedTCPIP;
BOOLEAN RequiresBinaryIpAddresses;
UCHAR VersionMin;
UCHAR VersionMax;
BOOLEAN MultifunctionDevice;
BOOLEAN CacheValid;
ULONG NumberOfPorts;
ULONG Status;
ULONG FunctionalitySupported;
UCHAR GenerationalGuid[16];
ULONG MaxCDBLength;
BOOLEAN BiDiScsiCommands;
WCHAR VendorID[255 + 1];
WCHAR VendorModel[255 + 1];
WCHAR VendorVersion[255 + 1];
WCHAR FirmwareVersion[255 + 1];
WCHAR AsicVersion[255 + 1];
WCHAR OptionRomVersion[255 + 1];
WCHAR SerialNumber[255 + 1];
WCHAR DriverName[255 + 1];
} MSiSCSI_HBAInformation, *PMSiSCSI_HBAInformation;
成员
UniqueAdapterId
一个 64 位整数,用于唯一标识 HBA 发起程序以及用于管理 HBA 的存储微型端口驱动程序的加载实例。 发起程序应使用适配器扩展的地址或其他设备驱动程序拥有的地址来构造此标识符(ID)。
IntegratedTCPIP
一个布尔值,该值指示 Windows TCP/IP 堆栈是否管理 HBA 的 TCP/IP 流量。 如果此成员 TRUE,则 Windows TCP/IP 堆栈管理 HBA 的 TCP/IP 流量。 如果此成员 FALSE,则 Windows TCP/IP 堆栈不会管理 HBA 的 TCP/IP 流量。 具有其自己的 TCP/IP 堆栈的适配器的微型端口驱动程序应将此成员设置为 FALSE。
RequiresBinaryIpAddresses
一个布尔值,该值指示 HBA 的微型端口驱动程序是否指示 iSCSI 发起程序服务执行 DNS 查找,并为 HBA 提供二进制 IP 地址。 如果此成员 TRUE,则 HBA 的微型端口驱动程序指示 iSCSI 发起程序服务执行 DNS 查找,并提供具有二进制 IP 地址的 HBA。 要使 iSCSI 发起程序服务遵循此请求,HBA 必须与 Windows TCP/IP 堆栈位于同一网络上。 如果 RequiresBinaryIpAddressesFALSE,则 HBA 及其微型端口驱动程序可以直接访问 DNS。
VersionMin
HBA 及其微型端口驱动程序支持的 iSCSI 规范的最早版本。
VersionMax
HBA 及其微型端口驱动程序支持的 iSCSI 规范的最新版本。
MultifunctionDevice
一个布尔值,该值指示 HBA 是否为多功能设备。 如果此成员 TRUE,则 HBA 是多功能设备,并公开网卡接口。 如果此成员 FALSE,则 HBA 不是多功能设备。
CacheValid
一个布尔值,该值指示适配器缓存是否为值。 如果此成员 TRUE,则适配器缓存有效。 如果此成员 FALSE,则缓存无效或适配器不缓存数据。
NumberOfPorts
适配器上的端口数(或 TCP/IP 地址)。
Status
HBA 的当前状态。 此成员可以保留以下任何值:
地位 | 意义 |
---|---|
ISCSI_HBA_STATUS_WORKING | HBA 正常运行。 |
ISCSI_HBA_STATUS_DEGRADED | HBA 正在以降级的作状态运行。 |
ISCSI_HBA_STATUS_CRITICAL | HBA 处于关键状态,随时可能失败。 |
ISCSI_HBA_STATUS_FAILED | HBA 根本不正常运行。 |
FunctionalitySupported
定义 HBA 支持的功能的按位 OR。 下表描述了可能的标志。
标志 | 意义 |
---|---|
ISCSI_HBA_PRESHARED_KEY_CACHE | 主机总线适配器 (HBA) 支持预共享密钥的载入缓存。 |
ISCSI_HBA_ISCSI_AUTHENTICATION_CACHE | HBA 支持 CHAP 机密的载入缓存。 |
ISCSI_HBA_IPSEC_TUNNEL_MODE | HBA 支持 IPsec 隧道模式。 |
ISCSI_HBA_CHAP_VIA_RADIUS | HBA 支持质询握手身份验证协议(CHAP)的远程身份验证拨入用户服务(RADIUS)属性。 |
ISCSI_HBA_ISNS_DISCOVERY | HBA 支持 iSNS 发现。 |
ISCSI_HBA_SLP_DISCOVERY | HBA 支持 SLP 发现。 |
GenerationalGuid[16]
代系 GUID。 此 GUID 是 SetGenerationalGuid 方法在 MSiSCSI_Operations WMI 类 最后一组的 GUID 值。
MaxCDBLength
HBA 支持的最大 CDB 长度(以字节为单位)。
BiDiScsiCommands
一个布尔值,该值指示 HBA 是否支持双向 SCSI 命令。 如果此成员 TRUE,则 HBA 支持双向 SCSI 命令。 如果此成员 FALSE,则 HBA 不支持双向命令。
VendorID[255 + 1]
HBA 的制造商。
VendorModel[255 + 1]
一个指定 HBA 模型的字符串。 制造商定义此字符串。
VendorVersion[255 + 1]
一个指定 HBA 版本的字符串。 制造商定义此字符串。
FirmwareVersion[255 + 1]
一个字符串,指定 HBA 中的固件版本。 制造商定义此字符串。
AsicVersion[255 + 1]
一个指定 Asic 版本的字符串。 制造商定义此字符串。
OptionRomVersion[255 + 1]
一个字符串,指定 HBA 的选项 ROM 版本。 制造商定义此字符串。
SerialNumber[255 + 1]
一个指定 HBA 序列号的字符串。 制造商定义此字符串。
DriverName[255 + 1]
一个字符串,指定 HBA 的驱动程序的名称。
言论
必须实现此类。
要求
要求 | 价值 |
---|---|
标头 | iscsimgt.h (包括 Iscsimgt.h) |