structure MSiSCSI_HBAInformation (iscsimgt.h)
La structure MSiSCSI_HBAInformation est utilisée par les pilotes miniports de stockage pour signaler des informations sur les adaptateurs de bus hôtes (HBA) qu’ils gèrent au service initiateur iSCSI.
Syntaxe
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;
Membres
UniqueAdapterId
Entier 64 bits qui identifie de manière unique un initiateur HBA et un instance chargé d’un pilote miniport de stockage qui gère l’adaptateur HBA. L’initiateur doit utiliser l’adresse de l’extension de l’adaptateur ou une autre adresse que le pilote de périphérique possède pour construire cet identificateur (ID).
IntegratedTCPIP
Valeur booléenne qui indique si la pile TCP/IP Windows gère le trafic TCP/IP pour l’adaptateur HBA. Si ce membre a la valeur TRUE, la pile TCP/IP Windows gère le trafic TCP/IP pour l’adaptateur HBA. Si ce membre a la valeur FALSE, la pile TCP/IP Windows ne gère pas le trafic TCP/IP pour l’adaptateur HBA. Un pilote miniport pour une carte avec sa propre pile TCP/IP doit définir ce membre sur FALSE.
RequiresBinaryIpAddresses
Valeur booléenne qui indique si le pilote miniport de l’adaptateur HBA demande au service initiateur iSCSI d’effectuer une recherche DNS et de fournir à l’adaptateur HBA des adresses IP binaires. Si ce membre a la valeur TRUE, le pilote miniport de l’adaptateur HBA demande au service initiateur iSCSI d’effectuer une recherche DNS et de fournir à l’adaptateur HBA des adresses IP binaires. Pour que le service initiateur iSCSI respecte cette demande, l’adaptateur HBA doit se trouver sur le même réseau que la pile TCP/IP Windows. Si RequiresBinaryIpAddresses a la valeur FALSE, l’adaptateur HBA et son pilote miniport ont un accès direct au DNS.
VersionMin
Version la plus ancienne de la spécification iSCSI prise en charge par l’adaptateur HBA et son pilote miniport.
VersionMax
Version la plus récente de la spécification iSCSI prise en charge par l’adaptateur HBA et son pilote miniport.
MultifunctionDevice
Valeur booléenne qui indique si l’adaptateur HBA est un appareil multifonction. Si ce membre a la valeur TRUE, l’adaptateur HBA est un appareil multifonction et il expose une interface netcard. Si ce membre EST FALSE, l’adaptateur HBA n’est pas un appareil multifonction.
CacheValid
Valeur booléenne qui indique si les caches de l’adaptateur sont une valeur. Si ce membre a la valeur TRUE, les caches de l’adaptateur sont valides. Si ce membre a la valeur FALSE, les caches ne sont pas valides ou l’adaptateur ne met pas en cache les données.
NumberOfPorts
Nombre de ports (ou d’adresses TCP/IP sur la carte).
Status
Le status actuel de HBA. Ce membre peut contenir l’une des valeurs suivantes :
| Statut | Signification |
|---|---|
| ISCSI_HBA_STATUS_WORKING | L’adaptateur HBA fonctionne normalement. |
| ISCSI_HBA_STATUS_DEGRADED | L’adaptateur HBA fonctionne dans un état de fonctionnement dégradé. |
| ISCSI_HBA_STATUS_CRITICAL | L’adaptateur HBA est dans un état critique et peut échouer à tout moment. |
| ISCSI_HBA_STATUS_FAILED | L’adaptateur HBA ne fonctionne pas du tout. |
FunctionalitySupported
Or au niveau du bit des indicateurs qui définissent la fonctionnalité prise en charge par l’adaptateur HBA. Le tableau suivant décrit les indicateurs possibles.
| Indicateurs | Signification |
|---|---|
| ISCSI_HBA_PRESHARED_KEY_CACHE | L’adaptateur de bus hôte (HBA) prend en charge un cache intégré pour une clé prépartagée. |
| ISCSI_HBA_ISCSI_AUTHENTICATION_CACHE | L’adaptateur HBA prend en charge un cache intégré pour les secrets CHAP. |
| ISCSI_HBA_IPSEC_TUNNEL_MODE | L’adaptateur HBA prend en charge le mode tunnel IPsec. |
| ISCSI_HBA_CHAP_VIA_RADIUS | L’adaptateur HBA prend en charge les attributs RADIUS (Remote Authentication Dial-In User Service) du protocole CHAP (Challenge HandsHake Authentication Protocol). |
| ISCSI_HBA_ISNS_DISCOVERY | L’adaptateur HBA prend en charge la découverte iSNS. |
| ISCSI_HBA_SLP_DISCOVERY | L’adaptateur HBA prend en charge la découverte SLP. |
GenerationalGuid[16]
GUID générationnel. Ce GUID est la valeur GUID que la méthode SetGenerationalGuid du dernier jeu de classe WMI MSiSCSI_Operations .
MaxCDBLength
Longueur CDB maximale, en octets, prise en charge par l’adaptateur HBA.
BiDiScsiCommands
Valeur booléenne qui indique si l’adaptateur HBA prend en charge les commandes SCSI bidirectionnelles. Si ce membre a la valeur TRUE, l’adaptateur HBA prend en charge les commandes SCSI bidirectionnelles. Si ce membre a la valeur FALSE, l’adaptateur HBA ne prend pas en charge les commandes bidirectionnelles.
VendorID[255 + 1]
Fabricant du HBA.
VendorModel[255 + 1]
Chaîne qui spécifie le modèle de l’adaptateur HBA. Le fabricant définit cette chaîne.
VendorVersion[255 + 1]
Chaîne qui spécifie la version de l’adaptateur HBA. Le fabricant définit cette chaîne.
FirmwareVersion[255 + 1]
Chaîne qui spécifie la version du microprogramme dans l’adaptateur HBA. Le fabricant définit cette chaîne.
AsicVersion[255 + 1]
Chaîne qui spécifie la version d’Asic. Le fabricant définit cette chaîne.
OptionRomVersion[255 + 1]
Chaîne qui spécifie la version rom d’option de l’adaptateur HBA. Le fabricant définit cette chaîne.
SerialNumber[255 + 1]
Chaîne qui spécifie le numéro de série de l’adaptateur HBA. Le fabricant définit cette chaîne.
DriverName[255 + 1]
Chaîne qui spécifie le nom du pilote pour l’adaptateur HBA.
Remarques
Vous devez implémenter cette classe.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | iscsimgt.h (inclure Iscsimgt.h) |