estructura MSiSCSI_HBAInformation (iscsimgt.h)

Artículo
02/07/2025

Los controladores de miniporte de almacenamiento usan la estructura MSiSCSI_HBAInformation para informar sobre los adaptadores de bus host (HBA) que administran en el servicio de iniciador iSCSI.

Sintaxis

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;

Miembros

UniqueAdapterId

Entero de 64 bits que identifica de forma única un iniciador de HBA y una instancia cargada de un controlador de miniporte de almacenamiento que administra el HBA. El iniciador debe usar la dirección de la extensión del adaptador u otra dirección que posee el controlador de dispositivo para construir este identificador (ID).

IntegratedTCPIP

Valor booleano que indica si la pila TCP/IP de Windows administra el tráfico TCP/IP para el HBA. Si este miembro es TRUE, la pila TCP/IP de Windows administra el tráfico TCP/IP para el HBA. Si este miembro es FALSE, la pila TCP/IP de Windows no administra el tráfico TCP/IP para el HBA. Un controlador de miniport para un adaptador con su propia pila TCP/IP debe establecer este miembro en FALSE.

RequiresBinaryIpAddresses

Valor booleano que indica si el controlador de miniport para el HBA indica al servicio iniciador iSCSI que realice la búsqueda DNS y proporcione el HBA con direcciones IP binarias. Si este miembro es TRUE, el controlador de miniport para el HBA indica al servicio iniciador iSCSI que realice la búsqueda DNS y proporcione el HBA con direcciones IP binarias. Para que el servicio de iniciador iSCSI respete esta solicitud, el HBA debe estar en la misma red que la pila TCP/IP de Windows. Si requireBinaryIpAddresses es FALSE, el HBA y su controlador de miniportar tienen acceso directo a DNS.

VersionMin

La versión más antigua de la especificación iSCSI que admite el HBA y su controlador de miniport.

VersionMax

La versión más reciente de la especificación iSCSI que admite el HBA y su controlador de miniport.

MultifunctionDevice

Valor booleano que indica si el HBA es un dispositivo multifunción. Si este miembro es TRUE, el HBA es un dispositivo multifunción y expone una interfaz de netcard. Si este miembro FALSE, el HBA no es un dispositivo multifunción.

CacheValid

Valor booleano que indica si las memorias caché del adaptador son valor. Si este miembro es TRUE, las memorias caché del adaptador son válidas. Si este miembro es FALSE, las memorias caché no son válidas o el adaptador no almacena en caché los datos.

NumberOfPorts

Número de puertos (o direcciones TCP/IP en el adaptador).

Status

Estado actual de HBA. Este miembro puede contener cualquiera de los siguientes valores:

Estado	Significado
ISCSI_HBA_STATUS_WORKING	El HBA funciona normalmente.
ISCSI_HBA_STATUS_DEGRADED	El HBA funciona en un estado degradado de funcionamiento.
ISCSI_HBA_STATUS_CRITICAL	El HBA está en un estado crítico y puede producir un error en cualquier momento.
ISCSI_HBA_STATUS_FAILED	El HBA no funciona en absoluto.

FunctionalitySupported

OR bit a bit de las marcas que definen la funcionalidad que admite el HBA. En la tabla siguiente se describen las marcas posibles.

Banderas	Significado
ISCSI_HBA_PRESHARED_KEY_CACHE	El adaptador de bus host (HBA) admite una caché incorporada para una clave previamente compartida.
ISCSI_HBA_ISCSI_AUTHENTICATION_CACHE	El HBA admite una caché incorporada para secretos chap.
ISCSI_HBA_IPSEC_TUNNEL_MODE	El HBA admite el modo de túnel IPsec.
ISCSI_HBA_CHAP_VIA_RADIUS	El HBA admite los atributos del servicio de usuario de acceso telefónico local (RADIUS) de autenticación remota del protocolo de autenticación de protocolo de enlace de desafío (CHAP).
ISCSI_HBA_ISNS_DISCOVERY	HBA admite la detección de iSNS.
ISCSI_HBA_SLP_DISCOVERY	HBA admite la detección de SLP.

GenerationalGuid[16]

GUID generacional. Este GUID es el valor GUID que método SetGenerationalGuid en la clase WMI MSiSCSI_Operations último conjunto.

MaxCDBLength

Longitud máxima de CDB, en bytes, que admite el HBA.

BiDiScsiCommands

Valor booleano que indica si el HBA admite comandos SCSI bidireccionales. Si este miembro es TRUE, HBA admite comandos SCSI bidireccionales. Si este miembro es FALSE, el HBA no admite comandos bidireccionales.

VendorID[255 + 1]

Fabricante del HBA.

VendorModel[255 + 1]

Cadena que especifica el modelo del HBA. El fabricante define esta cadena.

VendorVersion[255 + 1]

Cadena que especifica la versión del HBA. El fabricante define esta cadena.

FirmwareVersion[255 + 1]

Cadena que especifica la versión del firmware en el HBA. El fabricante define esta cadena.

AsicVersion[255 + 1]

Cadena que especifica la versión asic. El fabricante define esta cadena.

OptionRomVersion[255 + 1]

Cadena que especifica la versión rom de opción del HBA. El fabricante define esta cadena.

SerialNumber[255 + 1]

Cadena que especifica el número de serie del HBA. El fabricante define esta cadena.

DriverName[255 + 1]

Cadena que especifica el nombre del controlador para el HBA.

Observaciones

Debe implementar esta clase.

Requisitos

Requisito	Valor
encabezado de	iscsimgt.h (include Iscsimgt.h)

Consulte también

de clase WMI de MSiSCSI_HBAInformation

de clase WMI de MSiSCSI_Operations

SetGenerationalGuid

Compartir a través de