LLC_DLC_OPEN_SAP_PARMS

The LLC_DLC_OPEN_SAP_PARMS structure is the DLC parameter table for the LLC_DLC_OPEN_SAP command. You pass a pointer to this structure using the pParameterTable member of the CCB_PARMS union.

typedef struct {
  USHORT usStationId
  USHORT usUserStatValue; 
  UCHAR uchT1; 
  UCHAR uchT2; 
  UCHAR uchTi; 
  UCHAR uchMaxOut; 
  UCHAR uchMaxIn; 
  UCHAR uchMaxOutIncr; 
  UCHAR uchMaxRetryCnt; 
  UCHAR uchMaxMembers; 
  USHORT usMaxI_Field; 
  UCHAR uchSapValue; 
  UCHAR uchOptionsPriority; 
  UCHAR uchcStationCount; 
  UCHAR uchReserved2[2]; 
  UCHAR cGroupCount; 
  PUCHAR pGroupList; 
  ULONG DlcStatusFlags; 
  UCHAR uchReserved3[8]; 
  UCHAR cLinkStationsAvail; 
} LLC_DLC_OPEN_SAP_PARMS, *PLLC_DLC_OPEN_SAP_PARMS;

Members

usStationId

SAP or link station identifier.

usUserStatValue

Reserved for user.

uchT1

Response timer. If the value is zero, the default setting of 5 is used.

uchT2

Acknowledgment timer. If the value is zero, the default setting of 2 is used.

uchTi

Inactivity timer. If the value is zero, the default setting of 10 is used.

uchMaxOut

Maximum number of unacknowledged LLC_TRANSMIT commands. The limit for this value is 127. If the value is zero, the default setting of 2 is used.

uchMaxIn

Maximum number of unacknowledged LLC_RECEIVE commands. The limit for this value is 127. If the value is zero, the default setting of 1 is used.

uchMaxOutIncr

Dynamic window increment value.

uchMaxRetryCnt

Maximum number of retries for an unacknowledged command. The maximum valid value is 255. If the value is zero, the default setting of 8 is used.

uchMaxMembers

Maximum members for the group SAP.

usMaxI_Field

Maximum length of the information field. If the value is zero, the default setting of 600 is used.

uchSapValue

SAP value to be assigned.

uchOptionsPriority

SAP options and access priority. Specify one of the following options.

Option	Description
LLC_XID_HANDLING_IN_APPLICATION	The XID command frames for this SAP are passed to the application.
LLC_XID_HANDLING_IN_DLC	The XID command frames are handled for this SAP by the DLC function of the adapter.
LLC_INDIVIDUAL_SAP	The SAP is an individual SAP.
LLC_GROUP_SAP	The SAP is a group SAP.
LLC_MEMBER_OF_GROUP_SAP	The SAP may be a member of a group SAP.

uchcStationCount

Maximum number of link stations in the SAP. Provides resources for subsequent LLC_DLC_OPEN_STATION commands.

uchReserved2

Reserved.

cGroupCount

Number of group SAPs for this SAP. Valid values for the Token-Ring network are 0 through 8. Valid values for other networks are 0 through 255. If additional memberships are needed, use the LLC_DLC_MODIFY command.

pGroupList

Specifies the address of the group list. This member is ignored if cGroupCount is zero.

DlcStatusFlags

User notification flags for DLC status change.

uchReserved3

Reserved.

cLinkStationsAvail

Total number of available link stations.

Remarks

Opening an individual SAP requesting group SAP membership for a group SAP will fail if the membership is requested in group SAPs with different types. If this happens, the SAP opens with membership into the group SAPs specified until the SAP type of the group SAP listed changes. All subsequent group SAPs listed after a SAP type change has been detected will not be used for membership.

Requirements

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Windows 95/98: Requires Windows 95 or later.
  Header: Declared in Dlcapi.h.

See Also

The DLC Interface Overview, DLC Structures, AcsLan, CCB_PARMS