h324SetTrace

Defines the level of tracing for the H.324M Middleware. Applications can invoke h324SetTrace any time before or after invoking h324Initialize.

Prototype

DWORD h324SetTrace ( unsigned int LogToConsoleMask, unsigned int LogToFileMask)

Argument

Description

LogToConsoleMask

Tracing mask for the console.

LogToFileMask

Tracing mask for the log file.

The following bits can be turned on or off for both LogToConsoleMask and LogToFileMask:

Bit

Value

What gets logged

T_H245

0x00001

H.245 negotiations.

T_H245INFO

0x00002

Contents of some H.245 messages in binary form.

T_H245ERR

0x00004

H.245 stack errors.

T_H245ECHO

0x00008

Information about the H.324M Middleware functions called by the application.

T_EVENT

0x00010

Events processed by h324SubmitEvent.

T_APPEVENT

0x00020

Events generated by the H.324M Middleware.

T_APIECHO

0x00040

A message every time certain H.324M Middleware functions are called.

T_APIERR

0x00080

Additional information in cases of H.324M Middleware failures.

T_APIINFO

0x00100

Information about events consumed by the H.324M Middleware.

T_MUTEX

0x00200

A message every time the internal H.324M mutex is locked or unlocked.

T_MUXIFINFO

0x00400

Additional information related to the communication with the MUX or DEMUX.

T_MUXIFECHO

0x00800

MUX or DEMUX interface functions.

T_MUXIFERR

0x01000

Errors while communicating with the MUX or DEMUX.

T_H245MSGSUM

0x02000

NSRP related information.

T_H245MSGDET

0x04000

Detailed contents of H.245 messages received from the DEMUX in the binary form.

T_H245CALLB

0x08000

H.245 stack callback functions.

T_OLC

0x10000

Audio or video OLC state machine.

T_STACKINFO

0x20000

Reserved for future use.

T_STACKWARN

0x40000

Reserved for future use.

T_STACKERROR

0x80000

Reserved for future use.

T_ALL

0xFFFFF

Full tracing.

T_ALLERR

T_H245ERR + T_APIERR + T_MUXIFERR + T_STACKERROR + T_STACKWARN

Errors only.

T_NONE

0x00000

No tracing.

Return values

Return value

Description

SUCCESS

 

Events

None.

Example

To print errors only to the log file, use h324SetTrace in the following way:

H324SetTrace( 0, T_ALLERR );