ISCSI_SessionStaticInfo - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// iscsimgt.h
typedef struct _ISCSI_SessionStaticInfo {
ULONGLONG UniqueSessionId;
WCHAR InitiatoriSCSIName[223 + 1];
WCHAR TargetiSCSIName[223 + 1];
USHORT TSID;
UCHAR ISID[6];
BOOLEAN InitialR2t;
BOOLEAN ImmediateData;
UCHAR Type;
BOOLEAN DataSequenceInOrder;
BOOLEAN DataPduInOrder;
UCHAR ErrorRecoveryLevel;
ULONG MaxOutstandingR2t;
ULONG FirstBurstLength;
ULONG MaxBurstLength;
ULONG MaxConnections;
USHORT ConnectionCount;
ISCSI_ConnectionStaticInfo ConnectionsList[1];
} ISCSI_SessionStaticInfo, *PISCSI_SessionStaticInfo;
View the official Windows Driver Kit DDI referenceNo description available.
The ISCSI_SessionStaticInfo structure provides information about the characteristics of an iSCSI session.
UniqueSessionIdA 64-bit integer that uniquely identifies the session. The LoginToTarget and AddConnectionToSession methods both return this value in their UniqueSessionId parameter. Do not confuse this value with the values in the ISID and TSID members.
InitiatoriSCSINameA wide character string that specifies the initiator node name.
TargetiSCSINameA wide character string that specifies the node name of the target.
TSIDAn internal value that specifies the portion of the iSCSI session ID that the target provides. The iSCSI protocol uses TSID together with ISID to identify the session. Do not confuse TSID with the session ID that UniqueSessionId specifies.
ISIDAn internal value that specifies the portion of the iSCSI session ID that the initiator provides.
InitialR2tA Boolean value that indicates if the initiator must wait for a ready-to-send (R2T) request before sending data to the target. If this member is TRUE, the initiator must wait for a ready-to-send (R2T) request before sending data to the target. If this member is FALSE, the initiator can send unsolicited data within limits that the value of FirstBurstLength specifies.
ImmediateDataA Boolean value that indicates if the initiator and target have agreed to allow the transmission of immediate data in the session. (Immediate data is data that the initiator piggybacks onto an iSCSI command PDU.) If this member is TRUE, the initiator and target have agreed to allow the transmission of immediate data in this session.
TypeAn ISCSI_SESSION_TYPE_QUALIFIERS enumeration value that specifies the type of logon session.
| Type | Meaning |
|---|---|
| discoverySession | Session is being used only for discovery. |
| informationtalSession | Session is being used for a limited set of SCSI commands. |
| dataSession | Session is being used as a full feature session. |
| bootSession | Session is being used to boot from target. |
DataSequenceInOrderA Boolean value that indicates whether sequences of data PDUs must be transmitted by using continuously increasing offsets, except during error recovery. If this member is TRUE, sequences of data PDUs must be transmitted by using continuously increasing offsets, except during error recovery. If this member is FALSE, sequences of data PDUs can be transmitted in any order.
The value in DataSequenceInOrder indicates the ordering of the sequences themselves, not the ordering of the data PDUs within each sequence. The DataPduInOrder member indicates the ordering of the data PDUs within each sequence.
DataPduInOrderA Boolean value that indicates whether the data PDUs within a sequence of data PDUs must be located at continuously increasing addresses. If this member is TRUE, the data PDUs within a sequence of data PDUs must be located at continuously increasing addresses, with no gaps or overlay between PDUs. If this member is FALSE, the data PDUs within each sequence can be in any order.
ErrorRecoveryLevelThe level of error recovery that the initiator and the target negotiated. Higher numbers represent more elaborate recovery schemes. Currently, this member must be 0 or ULONG_VALUE_UNKNOWN.
MaxOutstandingR2tThe maximum number of outstanding ready-to-transmit (R2T) requests that are allowed for each task within this session.
FirstBurstLengthThe maximum amount of unsolicited data, in bytes, that you can send within this session.
MaxBurstLengthThe maximum number of bytes that you can send within a single sequence of Data-In or Data-Out PDUs.
MaxConnectionsThe maximum number of connections that are allowed within this session.
ConnectionCountThe number of connections that currently belong to this session.
ConnectionsListA variable length array of ISCSI_ConnectionStaticInfo structures that specifies the static configuration data for each connection that is associated with this session. ConnectionCount indicates the number of elements in the array.