Prosody RTP processing: API: sm_vidmprx_config_codec_rfc4629

This function is deprecated.

Prototype Definition

int sm_vidmprx_config_codec_rfc4629(struct sm_vidmprx_codec_rfc4629_parms *codecp)

Parameters

*codecp
a structure of the following type: 
typedef struct sm_vidmprx_codec_rfc4629_parms {
	tSMVidMPrxId vidmprx;					/* in */
	tSM_INT payload_type;					/* in */
	tSM_INT h263_profile;					/* in */
	tSM_INT h263_level;					/* in */
} SM_VIDMPRX_CODEC_RFC4629_PARMS;

Description

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

The de-packetiser accepts RTP packets as input, and composes Audio Video Format (AVF) frames as output, which the VidMP[rx] makes available via its datafeed.

It is possible to change the payload type mapping of a de-packetiser whilst a VidMP[rx] remains valid by specifying a new payload type mapping for a given de-packetiser. This supersedes any previous mappings that were in effect for that de-packetiser.

If the call completes successfully, RTP packets arriving at the VidMP[rx] with a payload type that matches a mapped type will be decoded using this de-packetiser.

If the de-packetiser is given the payload type -1 the de-packetiser is no longer valid for this RTP session, unless it is subsequently reconfigured.

On starting to receive RTP packets, a newly configured de-packetiser will not emit any AVF frames until it is reasonably certain that the first valid and complete H.263 Intra (I-) Frame has been received. Waiting for an I-Frame attempts to ensure that the video, when later rendered, 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

vidmprx (Deprecated)
The VidMP[rx] to which to add the de-packetiser
payload_type (Deprecated)
The payload type identifer to use with this de-packetiser (see IETF RFC 3550 section 13). Supplying a value of -1 will remove any payload type configuration from the de-packetiser preventing its use.
h263_profile (Deprecated)
The H.263 profile value with which the de-packetiser should populate the outgoing data stream. This should be set to a value between 0 and 10, inclusive. Values outside this range will be limited to the range. For further information please see the ITU-T H.263 (01/2005) specification, Annex X.
h263_level (Deprecated)
The H.263 level value with which the de-packetiser should populate the outgoing data stream. If this value is set to 0, a default level of 10 will be used. This should be set to a value between 0 and 100, inclusive. Values outside this range will be limited to the range. For further information please see the ITU-T H.263 (01/2005) specification, Annex X.

Returns

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

This function is part of the Prosody RTP processing API.