Initializing the H.324M Middleware

Initialize the H.324M Middleware by using h324Initialize. This function must be called only once by the application.

The H.324M Middleware supports an optional h324.cfg configuration file that h324Initialize reads when invoked. The h.324.cfg file is located in the following directory:

Each line of the configuration file specifies a different parameter value. The format of a line is:

Parameter = Value

Any text appearing after a # character is ignored as a comment. The following table describes the h324.cfg configuration file configuration parameters.

Parameter

Type

Default

Description

AsymmetricRecoveryMasterTimeout

int

4000

Amount of time, in ms, that the H.324M Middleware waits before starting the non-standard recovery procedure.

This field applies only when AsymmetricVideoCodecsRecovery is set to 1 (enabled).

AsymmetricVideoCodecsRecovery

int

0

Enable or disable the non-standard recovery procedure when asymmetric video codecs are used. Values are:

0 – Disable the non-standard recovery procedure.

1 - Enable the non-standard recovery procedure.

The H.324M Middleware can use the non-standard recovery procedure to recover a call when a 3G phone sends a unidirectional OLC request that uses an incorrect video codec (one that is not preferred by the master).

h245MsgLogDuration

int

0

If the h245 logging file is enabled, specifies the number of seconds to wait before changing to a new file.  

Default value 0, specifies unlimited duration.

h245MsgLogEnabled

int

0

Enable or disable logging decoded H.245 messages. Values are:

0 – Disable logging decoded H.245 messages

1 – Enable logging decoded H.245 messages

h245MsgLogNumFiles

int

1

Only used if the h245 logging file is enabled and h245TraceDuration does not equal 0.

Specifies the maximum number of h245 log files to keep on the system.  

Valid range is 1 - 1000.

h245MsgLogFileName

string

h245_msg.log.txt

Log file name for decoded H.245 messages.

h245TraceDuration

int

0

If the h245 tracing file is enabled, specifies the number of seconds to wait before changing to a new file.  

A value of 0 (the default) specifies unlimited duration.

h245TraceNumFiles

int

1

Only used if the h245 tracing file is enabled and h245TraceDuration does not equal 0.

Specifies the maximum number of 245 trace files to keep on the system.  

Valid range is 1 - 1000.

h245TraceFileName

string

H245.log

Trace file for logging H.245 protocol messages.

h245TraceLevel

int

0

Level of trace messages to generate. Bit mask values are:

0 - Disable trace levels.

1 – Generate H.245 error messages.

2 – Generate low-level H.245 messages.

4 – Generate high-level H.245 messages.

8 – Generate low-level H.245 debug messages.

16 – Generate high-level H.245 debug messages.

h245TraceMode

int

2

Where to write trace messages:

1 – Write trace messages to the console.

2 – Write trace messages to the trace file.

3 – Write trace messages to both the console and the trace file.

h245TraceModules

int

0

Category of messages to trace. Bit mask values are:

0 – Disable trace modules.

1 – Trace MSD messages.

2 – Trace TCS messages.

4 – Trace MES messages.

8 – Trace RME messages.

16 – Trace RTD messages.

32 – Trace OLC messages.

64 – Trace system messages.

128 – Trace request messages.

256 – Trace indication messages.

512 – Trace command messages.

1024 – ML messages.

2048 – Trace timer messages.

4096 – Trace memory messages.

h324TraceDuration

int

0

If the h324 tracing file is enabled, specifies the number of seconds to wait before changing to a new file.  

Default value specifies an unlimited duration.

h324TraceNumFiles

int

1

Only used if the h324 tracing file is enabled and h324TraceDuration does not equal 0. Specifies the maximum number of h324 trace files to keep on the system.  

Valid range is 1 - 1000.

LegacySyncFlagThreshold

int

5

Only used if MONA is not enabled. Specifies the number of H.223 Level 2 sync flags needed to return H324EVN_START_DONE.

Valid range is 1 – 20.

max_n400_retrans_counter

int

5

N400 NSRP/WNSRP retransmission counter.

max_n402_counter

int

2

Only used if WNSRP is enabled. The H.324M Middleware switches to NSRP mode when it receives max_n402_counter NSRP responses.

maxAL2SDUSize

int

1024

Maximum AL2 SDU size in the terminal capability request.

maxAL3SDUSize

int

1024

Maximum AL3 SDU size in the terminal capability request.

mona

int

0

Enable or disable MONA. Values are:

0 – Disable MONA

1 – Enable MONA

nsrp_mode

int

2

NRSP protocol implementation. Values are:

2 – Enables NSRP and disables WNSRP.

3 – Enables NSRP and WNSRP.

pack_h245

int

2

Enable or disable the use of packed H.245 messages. Values are:

1 – Enable packed H.245 messages.

2 – Disable packed H.245 messages.

StartTimeoutDuration

int

5000

Amount of time (in ms) allowed for h324Start to complete processing before the Middleware generates an H324EVN_START_TIMER_EXPIRED event.

t401_timer_duration

int

1000

Duration, in ms, of the T401 NRSP/WNSRP acknowledgement timer.