struktur MSiSCSI_HBAInformation (iscsimgt.h)
Struktur MSiSCSI_HBAInformation digunakan oleh driver miniport penyimpanan untuk melaporkan informasi tentang adaptor bus host (HBA) yang mereka kelola ke layanan inisiator iSCSI.
Sintaks
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;
Anggota
UniqueAdapterId
Bilangan bulat 64-bit yang secara unik mengidentifikasi inisiator HBA dan instans yang dimuat dari driver miniport penyimpanan yang mengelola HBA. Inisiator harus menggunakan alamat ekstensi adaptor atau alamat lain yang dimiliki driver perangkat untuk membuat pengidentifikasi (ID) ini.
IntegratedTCPIP
Nilai Boolean yang menunjukkan apakah tumpukan TCP/IP Windows mengelola lalu lintas TCP/IP untuk HBA. Jika anggota ini TRUE, tumpukan TCP/IP Windows mengelola lalu lintas TCP/IP untuk HBA. Jika anggota ini FALSE, tumpukan Windows TCP/IP tidak mengelola lalu lintas TCP/IP untuk HBA. Driver miniport untuk adaptor dengan tumpukan TCP/IP sendiri harus mengatur anggota ini ke FALSE.
RequiresBinaryIpAddresses
Nilai Boolean yang menunjukkan apakah driver miniport untuk HBA menginstruksikan layanan inisiator iSCSI untuk melakukan pencarian DNS dan menyediakan HBA dengan alamat IP biner. Jika anggota ini TRUE, driver miniport untuk HBA menginstruksikan layanan inisiator iSCSI untuk melakukan pencarian DNS dan menyediakan HBA dengan alamat IP biner. Agar layanan inisiator iSCSI mematuhi permintaan ini, HBA harus berada di jaringan yang sama dengan tumpukan TCP/IP Windows. Jika RequiresBinaryIpAddressesFALSE, HBA dan driver miniport-nya memiliki akses langsung ke DNS.
VersionMin
Versi paling awal dari spesifikasi iSCSI yang didukung HBA dan driver miniport-nya.
VersionMax
Versi terbaru dari spesifikasi iSCSI yang didukung HBA dan driver miniport-nya.
MultifunctionDevice
Nilai Boolean yang menunjukkan apakah HBA adalah perangkat multifungsi. Jika anggota ini TRUE, HBA adalah perangkat multifungsi, dan mengekspos antarmuka netcard. Jika anggota ini FALSE, HBA bukan perangkat multifungsi.
CacheValid
Nilai Boolean yang menunjukkan apakah cache adaptor adalah nilai. Jika anggota ini TRUE, cache adapter valid. Jika anggota ini FALSE, cache tidak valid atau adaptor tidak menyimpan data.
NumberOfPorts
Jumlah port (atau alamat TCP/IP pada adaptor).
Status
Status HBA saat ini. Anggota ini dapat menyimpan salah satu nilai berikut:
| Status | Makna |
|---|---|
| ISCSI_HBA_STATUS_WORKING | HBA berfungsi secara normal. |
| ISCSI_HBA_STATUS_DEGRADED | HBA berfungsi dalam keadaan operasi yang terdegradasi. |
| ISCSI_HBA_STATUS_CRITICAL | HBA dalam keadaan kritis dan mungkin gagal kapan saja. |
| ISCSI_HBA_STATUS_FAILED | HBA tidak berfungsi sama sekali. |
FunctionalitySupported
BITWISE OR dari bendera yang menentukan fungsionalitas yang didukung HBA. Tabel berikut ini menjelaskan kemungkinan bendera.
| Bendera | Makna |
|---|---|
| ISCSI_HBA_PRESHARED_KEY_CACHE | Adaptor bus host (HBA) mendukung cache onboard untuk kunci yang dibagikan sebelumnya. |
| ISCSI_HBA_ISCSI_AUTHENTICATION_CACHE | HBA mendukung cache onboard untuk rahasia CHAP. |
| ISCSI_HBA_IPSEC_TUNNEL_MODE | HBA mendukung mode terowongan IPsec. |
| ISCSI_HBA_CHAP_VIA_RADIUS | HBA mendukung atribut Remote Authentication Dial-In User Service (RADIUS) dari protokol autentikasi jabat tangan tantangan (CHAP). |
| ISCSI_HBA_ISNS_DISCOVERY | HBA mendukung penemuan iSNS. |
| ISCSI_HBA_SLP_DISCOVERY | HBA mendukung penemuan SLP. |
GenerationalGuid[16]
GUID generasi. GUID ini adalah nilai GUID yang ditetapkan metode SetGenerationalGuid di MSiSCSI_Operations WMI Class .
MaxCDBLength
Panjang CDB maksimum, dalam byte, yang didukung HBA.
BiDiScsiCommands
Nilai Boolean yang menunjukkan apakah HBA mendukung perintah SCSI dua arah. Jika anggota ini TRUE, HBA mendukung perintah SCSI dua arah. Jika anggota ini FALSE, HBA tidak mendukung perintah dua arah.
VendorID[255 + 1]
Produsen HBA.
VendorModel[255 + 1]
String yang menentukan model HBA. Produsen mendefinisikan string ini.
VendorVersion[255 + 1]
String yang menentukan versi HBA. Produsen mendefinisikan string ini.
FirmwareVersion[255 + 1]
String yang menentukan versi firmware di HBA. Produsen mendefinisikan string ini.
AsicVersion[255 + 1]
String yang menentukan versi Asic. Produsen mendefinisikan string ini.
OptionRomVersion[255 + 1]
String yang menentukan opsi versi ROM HBA. Produsen mendefinisikan string ini.
SerialNumber[255 + 1]
String yang menentukan nomor seri HBA. Produsen mendefinisikan string ini.
DriverName[255 + 1]
String yang menentukan nama driver untuk HBA.
Keterangan
Anda harus menerapkan kelas ini.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header | iscsimgt.h (termasuk Iscsimgt.h) |