Prosody RTP processing: API: sm_vidmptx_config_codec_rfc4629

This function is deprecated.

Prototype Definition

int sm_vidmptx_config_codec_rfc4629(struct sm_vidmptx_codec_rfc4629_parms *codecp)

Parameters

*codecp
a structure of the following type:
typedef struct sm_vidmptx_codec_rfc4629_parms {
	tSMVidMPtxId vidmptx;					/* in */
	tSM_INT payload_type;					/* in */
	tSM_INT rem_ext_pic_hdr;				/* in */
} SM_VIDMPTX_CODEC_RFC4629_PARMS;

Description

Configures an RFC 4629 packetiser, as defined in IETF RFC 4629, to the VidMP[tx] setting the payload type mapping to payload_type.

The packetiser accepts Audio Video Format (AVF) frames from the VidMP[tx] incoming datafeed as input, and composes RTP packets as output.

A newly configured packetiser will not emit any RTP packets until it receives an H.263 I-Frame in the incoming AVF stream. Waiting for an I-Frame attempts to ensure that the video, when rendered by the remote endpoint, starts cleanly and without the picture disruption which will occur were the rendering decoder to attempt to decode Predicted (P-) Frames without an I-Frame as reference.

Fields

vidmptx (Deprecated)
The VidMP[tx] to which to add the packetiser
payload_type (Deprecated)
The payload type identifer to use with this packetiser (see IETF RFC 3550 section 13). Supplying a value of -1 will remove any payload type configuration from the packetiser preventing its use.
rem_ext_pic_hdr (Deprecated)
Allows handling of the extra picture header to be modified. If set to 0, each packet containing an extra picture header is transmitted as a whole. Otherwise, each such packet is transmitted with the extra picture header removed. See IETF RFC 4629 section 5.1. This behaviour allows interworking with non-conformant endpoints which require a zero length extra picture header.

Returns

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


This function is part of the Prosody RTP processing API.