Prosody H.223 Mux: API: sm_h223mux_reconfig

This function is under development. It could be changed or withdrawn, and may not be implemented in this release.

Prototype Definition

int sm_h223mux_reconfig(struct sm_h223mux_reconfig_parms *reconfigp)

Parameters

*reconfigp

a structure of the following type:

typedef struct sm_h223mux_reconfig_parms {
	tSMH223muxId h223mux;					/* in */
	enum kSMH223muxReconfigLevelChangeDirection {
		kSMH223muxReconfigLevelChangeDirectionTransmit,
		kSMH223muxReconfigLevelChangeDirectionReceive,
	} direction;						/* in */
	struct {
		enum kSMH223muxReconfigChoice {
			kSMH223muxReconfigModeChange,
			kSMH223muxReconfigAnnexADoubleFlag,
		} choice;
		union {
			enum kSMH223muxReconfigModeChange {
				kSMH223muxReconfigModeChangeToLevel0,
				kSMH223muxReconfigModeChangeToLevel1,
				kSMH223muxReconfigModeChangeToLevel2,
				kSMH223muxReconfigModeChangeToLevel2WithOptionalHeader,
			} mode_change;
			enum kSMH223muxReconfigAnnexADoubleFlag {
				kSMH223muxReconfigAnnexADoubleFlagStart,
				kSMH223muxReconfigAnnexADoubleFlagStop,
			} annex_a_double_flag;
		} u;
	} multiplex_reconfiguration;
} SM_H223MUX_RECONFIG_PARMS;

Description

Reconfigure the H.223 multiplex ie changing to another level, or adopting double flag mode vs. basic flag.

Fields

h223mux (Only in Preliminary Documentation)

The mux to reconfigure.

direction (Only in Preliminary Documentation)

The direction of dynamic level change request.

One of these values:

kSMH223muxReconfigLevelChangeDirectionTransmit

Indicates that the transmitter side shall change from current to new level ie. H.245 command h223ModeChange was received from the remote end.

kSMH223muxReconfigLevelChangeDirectionReceive

Indicates that the receiver side shall change from current to new level ie. H.245 command h223ModeChange was sent to the remote end.

multiplex_reconfiguration (Only in Preliminary Documentation)

choice

Reconfiguration options. One of these values:

kSMH223muxReconfigModeChange

Change the level of multiplex mode as described in Annex C/H.324 to level 0, level 1, level 2 or level 2 with Annex B/H.223 optional header.

kSMH223muxReconfigAnnexADoubleFlag

Start or stop the use of double-flag mode of Annex A/H.223.

u

mode_change

This parameter is only valid if reconfiguration choice is kSMH223muxReconfigModeChange. One of these values:

kSMH223muxReconfigModeChangeToLevel0

kSMH223muxReconfigModeChangeToLevel1

kSMH223muxReconfigModeChangeToLevel2

kSMH223muxReconfigModeChangeToLevel2WithOptionalHeader

annex_a_double_flag

This parameter is only valid if reconfiguration choice is kSMH223muxReconfigAnnexADoubleFlag One of these values:

kSMH223muxReconfigAnnexADoubleFlagStart

kSMH223muxReconfigAnnexADoubleFlagStop

Returns

0 if call completed successfully, otherwise a standard error such as:

• ERR_SM_DEVERR - device error

This function is part of the Prosody H.223 Mux API.