Platform SDK: TAPI

Create a Simple Conference

The following code snippet demonstrates the creation of a simple conference call. For information on IP multicast multimedia video conferencing, please see About Rendezvous IP Telephony Conferencing.

Before using this code snippet, a call must be in progress, and you must perform the operations in Make a Call or Receive a Call have been performed.

Note  This snippet does not have the error checking and releases appropriate for real code.

C++ Code Snippet

// From elsewhere in your code, you have obtained
// pBasicCall and pCallInfo, which are pointers to the 
// ITBasicCallControl and ITCallInfo interfaces
// of a call currently in progress.
// pAddress is an ITAddress pointer.

// Create a consultation call for the conference.
ITBasicCallControl *pConsultCall;
pAddress->CreateCall(
    bstrAddressToCall,
    dwAddressType,
    &pConsultCall
    );

// Move the consultation call into your conference.
// Note: If a CallHub object does not already
// exist, TAPI will create it.
pBasicCall->Conference(
          pConsultCall,
          VARIANT_TRUE
          );

// Finish the creation of the conference.
pConsultCall->Finish(FM_ASCONFERENCE);

// Assuming the Finish method succeeds,
// the consultation call (pConsultCallA)
// may transition to the CS_DISCONNECTED state
// or may remain connected, depending on the
// service provider.
//
// Get the ITCallHub interface pointer.
ITCallHub *pCallHub;
pCallInfo->get_CallHub( pCallHub );

// You can use the ITCallHub interface
// to obtain additional information on
// the conference. Specific capabilities
// depend on the TSP/MSP being used.

See Also

ITCallInfo, ITBasicCallControl, ITCallHub