Creates a new conference.

DWORD cnfCreateConference (
CNFRESOURCEHD cnfresourcehd,
CNF_CONFERENCE_PARMS *parms,
DWORD *confid)

cnfresourcehd Handle returned by cnfOpenResource.

parms Pointer to a CNF_CONFERENCE_PARMS structure:

typedef struct
{
DWORD   size;                          /* Size of the structure */
DWORD   flags;       /* Flags to describe capabilities not used */
DWORD   allocated_members;      /* Number of members to allocate*/
DWORD  user_value;                /*Application-provided value*/
} CNF_CONFERENCE_PARMS; 

See the Details section for a description of these fields.

If parms is NULL, take the default parameters.

confid Pointer for the new conference identifier.

• SUCCESS
• CTAERR_BAD_ARGUMENT
  confid is a NULL pointer.
• CTAERR_BOARD_ERROR
  The conference cannot be created because of an HMIC limitation or an on-board memory limitation (only with AG 2000 boards).
• CTAERR_INVALID_HANDLE
  cnfresourcehd is not a valid conferencing resource handle.
• CNFERR_BOARD_TIMEOUT
  The board timed out while waiting for a response message.
• CNFERR_INVALID_PARAMETER
  parms is inconsistent or out of range.
• CNFERR_NOT_ENOUGH_RESOURCE_SPACE
  The conference cannot be created because the conferencing resource is full.

This function creates a new conference on the resource specified by cnfresourcehd. If the function succeeds, the new conference identifier is returned in confid.

The CNF_CONFERENCE_PARMS structure contains the following fields:

Field	Description
flags	When set, specifies the capabilities the conference does not plan to use. You can disable capabilities at the resource level (in the cnf.cfg as described in Section 2.5.3) or at the conference level. NaturalConference optimizes the conferencing resource usage according to which capabilities are used, and can possibly allow the use of more members on the resource if enough system resources are freed up.
allocated_members	The number of members NaturalConference reserves for the conference. Whether the allocated members are used (joined) or not, the corresponding space is reserved on the conferencing resource. The allocated space can be modified by calling cnfResizeConference.
user_value	An application-supplied value or pointer that can be retrieved by calling cnfGetConferenceInfo.

Use the following flags to disable capabilities at the conference level:

Keyword	Disables...
CNF_NO_ECHO_CANCEL	Echo cancellation capability.
CNF_NO_DTMF_CLAMPING	DTMF suppression capability.
CNF_NO_MAPPING	Mapping capability.
CNF_NO_TONE_CLAMPING	Tone suppression capability.

Refer to Section 4.5 for more information on creating conferences.

cnfGetConferenceInfo, cnfGetResourceList, cnfResizeConference

extern CNFRESOURCEHD cnfresourcehd;
 
DWORD myCreateConference(unsigned allocated)
{
   DWORD confid;
   DWORD error;
   CNF_CONFERENCE_PARMS confparms;

   confparms.size = sizeof(CNF_CONFERENCE_PARMS);
   confparms.allocatedmembers = allocated;
   confparms.flags = CNF_NO_ECHO_CANCEL | CNF_NO_TONE_CLAMPING;
   confparms.user_value = NULL;
   error = cnfCreateConference (cnfresourcehd, &confparms,
            &confid); 
   if (error != SUCCESS)
      {
      printf("Error when creating conference : %d", error);
      return(error);
      }
   return(confid);   
}