# h324GetTermCaps

Queries the H.324M Middleware for local or remote terminal capabilities.

#### Prototype

DWORD h324GetTermCaps ( MSPHD msphd, WORD location, H324_TERM_CAPS * termCaps)

Argument | Description
msphd | MSPP handle associated with the MUX endpoint..
location | Indicates whether the function applies to the local terminal capabilities set or the remote terminal capabilities set. Valid values are: H324_LOCAL_TERMINAL - Local terminal capabilities set. H324_REMOTE_TERMINAL - Remote terminal capabilities set.
termCaps | Pointer to the H324_TERM_CAPS structure, which communicates the MUX and media capabilities of 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

For the outbound terminal capabilities set, use h324GetTermCaps to retrieve the default set of terminal capabilities structures based on either the:

- List of capabilities defined in the start parameters structure.

- Default list of AMR and MPEG-4 (if no start parameters were provided).

You then edit specific parameters in these structures as required, and pass them back to the H.324M Middleware using h324SetTermCaps.

For the inbound terminal capabilities set, you can retrieve a copy of the set at any time after receiving the H324EVN_REMOTE_CAPS. If you issue this request before receiving the H324EVN_REMOTE_CAPS, the function returns H324ERR_INTERNAL_ERROR.

If no terminal capabilities have been set by the application, the default terminal capabilities are returned.

#### Example

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