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
HBA 초기자 및 HBA를 관리하는 스토리지 미니포트 드라이버의 로드된 instance 고유하게 식별하는 64비트 정수입니다. 초기자는 어댑터 확장의 주소 또는 디바이스 드라이버가 소유한 다른 주소를 사용하여 이 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 조회를 수행하고 HBA에 이진 IP 주소를 제공하도록 지시합니다. iSCSI 초기자 서비스가 이 요청을 적용하려면 HBA가 Windows TCP/IP 스택과 동일한 네트워크에 있어야 합니다. RequiresBinaryIpAddresses가 FALSE이면 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는 MSiSCSI_Operations WMI 클래스의 SetGenerationalGuid 메서드가 마지막으로 설정한 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 포함) |