структура MSiSCSI_HBAInformation (iscsimgt.h)

Статья
02/07/2025

Структура MSiSCSI_HBAInformation используется драйверами минипорта хранилища для получения сведений об адаптерах шины узла (HBAs), которыми они управляют службой инициатора iSCSI.

Синтаксис

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. Инициатор должен использовать адрес расширения адаптера или другой адрес, принадлежащий драйверу устройства для создания этого идентификатора (идентификатора).

IntegratedTCPIP

Логическое значение, указывающее, управляет ли стек TCP/IP Windows трафиком TCP/IP для HBA. Если этот элемент TRUE, стек TCP/IP Windows управляет трафиком TCP/IP для HBA. Если этот элемент FALSE, стек TCP/IP Windows не управляет трафиком TCP/IP для HBA. Мини-драйвер для адаптера с собственным стеком TCP/IP должен задать для этого элемента значение FALSE.

RequiresBinaryIpAddresses

Логическое значение, указывающее, будет ли минипорт-драйвер для HBA указывать службе инициатора iSCSI выполнять поиск DNS и предоставлять HBA с двоичными IP-адресами. Если этот член TRUE, минипорт-драйвер для HBA указывает службе инициатора iSCSI выполнять поиск DNS и предоставлять HBA с двоичными IP-адресами. Чтобы служба инициатора iSCSI учитывала этот запрос, HBA должна находиться в той же сети, что и стек TCP/IP Windows. Если RequiresBinaryIpAddressesFALSE, HBA и его минипорт-драйвер имеют прямой доступ к DNS.

VersionMin

Самая ранняя версия спецификации iSCSI, поддерживаемая HBA и его мини-драйвером.

VersionMax

Последняя версия спецификации iSCSI, поддерживаемая HBA и его мини-драйвером.

MultifunctionDevice

Логическое значение, указывающее, является ли HBA многофункциональным устройством. Если этот элемент TRUE, HBA является мультифункциональным устройством и предоставляет интерфейс netcard. Если этот элемент 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. В следующей таблице описаны возможные флаги.

Флаги	Значение
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 поддерживает атрибуты службы пользователей удаленной проверки подлинности (RADIUS) протокола проверки подлинности (CHAP).
ISCSI_HBA_ISNS_DISCOVERY	HBA поддерживает обнаружение iSNS.
ISCSI_HBA_SLP_DISCOVERY	HBA поддерживает обнаружение SLP.

GenerationalGuid[16]

GUID поколения. Этот GUID — это значение GUID, которое метод SetGenerationalGuid в последнем наборе класса WMI MSiSCSI_Operations.

MaxCDBLength

Максимальная длина CDB в байтах, которую поддерживает HBA.

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. Производитель определяет эту строку.

SerialNumber[255 + 1]

Строка, указывающая серийный номер HBA. Производитель определяет эту строку.

DriverName[255 + 1]

Строка, указывающая имя драйвера для HBA.

Замечания

Этот класс необходимо реализовать.

Требования

Требование	Ценность
заголовка	iscsimgt.h (include Iscsimgt.h)

См. также

MSiSCSI_HBAInformation класс WMI

класса WMI MSiSCSI_Operations

SetGenerationalGuid

Поделиться через