You are here: SwitchKit® Development Environment Programmer’s Guide > 3 Channel Management > sk_associateChannelGroup()
Description
The sk_associateChannelGroup() function is used to manage the physical channels mapping to logical channel groups. When the automatic configuration facilities in EXS SwitchManager are used, this function is not needed. If a group does not exist, sk_associateChannel
Group() automatically creates the group. The function call is cumulative, so if you want to build a non-contiguous set of channels, just issue multiple sk_associateChannelGroup() function calls. This function is also available as sk_associateChannelGroupOnConnection() and skts_associateChannelGroup().
int sk_associateChannelGroup(char *aChannelGroup, int aStartSpan, int aStartChannel, int anEndSpan, int anEndChannel);
int sk_associateChannelGroupOnConnection(char *aChannelGroup, int aStartSpan, int aStartChannel, int anEndSpan, int anEndChannel, int aConID);
int skts_associateChannelGroupOnConnection(char *aChannelGroup, int aStartSpan, int aStartChannel, int anEndSpan, int anEndChannel, int aConID);
The function parameters are shown in the table below.
Argument |
Description |
---|---|
aChannelGroup |
Identifies the channel group. |
aStartSpan |
Identifies the first span in the group. |
aStartChannel |
Identifies the first chan in the group. |
anEndSpan |
Identifies the last span in the group. |
anEndChannel |
Identifies the last chan in the group. |
aConID |
A connection identifier specified at connection creation time and used to indicate which LLC an application wishes to communicate with. |
Possible return values for this function:
SK_LOST_LLC |
This return value indicates that your application lost contact with the LLC. |