h324SetTermCaps

Sets the local terminal capabilities for the terminal, and initiates the transfer of the terminal capabilities set if h324SetupCall has already been called. These values are used in the terminal capabilities exchange and in the open logical channel messages.

Prototype

DWORD h324SetTermCaps ( MSPHD msphd, H324_TERM_CAPS * termCaps)

Argument

Description

msphd

MSPP handle associated with the MUX endpoint.

termCaps

Pointer to H324_TERMCAPS structure that communicates the MUX and media capabilities of the both the remote terminal and the host application:

typedef struct tag_H324_TERM_CAPS
{
   DWORD                    size;
    MULTIPLEX_CAPABILITY      muxCap;
   DWORD                     wCapCount; // Number of caps
   H324_MEDIA_CAPABILITY    capTable[16];
} H324_TERM_CAPS;

For information about the fields in this structure, see H324_TERM_CAPS.

Return values

Return value	Description
SUCCESS
CTAERR_NOT_FOUND	msphd was not found. Either h324Start was not called or h324Delete was called.
H324ERR_INTERNAL_ERROR	Internal error in the 3G-324M Middleware.
H324ERR_MUTEX_LOCK_FAILED	Internal error trying to lock mutex.
H324ERR_NOT_INITIALIZED	h324Initialize was not called first.

Events

None.

Details

h324SetTermCaps allows you to modify capability parameters defined in h324Start.

If termCaps = NULL, the default terminal capabilities are used.

The default terminal capabilities set supports video with AL3 and AL2.

Example

ret = h324GetTermCaps( pCfg-> MuxEp.hd, H324_LOCAL_TERMINAL, & pCfg-> localTermCaps);
if ( ret != SUCCESS)
{
  printf("h324GetTermCaps. Return code is % x\n", ret);
  return ret;
}
printf("Call to Local h324GetTermCaps returned %d capabilities\n",
        pCfg-> localTermCaps.wCapCount );

ret = h324SetTermCaps( pCfg-> MuxEp.hd, & pCfg-> localTermCaps);
{
  printf("h324GetTermCaps. Return code is % x\n", ret);
  return ret;
}