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.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in dlcapi.h.

See Also

The DLC Interface Overview, DLC Structures, AcsLan, CCB_PARMS