res_pjsip_session_caps.h File Reference

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
struct ast_format_cap *	ast_sip_create_joint_call_cap (const struct ast_format_cap *remote, struct ast_format_cap *local, enum ast_media_type media_type, struct ast_flags codec_pref)
	Create joint capabilities. More...
struct ast_format_cap *	ast_sip_session_create_joint_call_cap (const struct ast_sip_session *session, enum ast_media_type media_type, const struct ast_format_cap *remote)
	Create joint capabilities. More...
struct ast_stream *	ast_sip_session_create_joint_call_stream (const struct ast_sip_session *session, struct ast_stream *remote)
	Create a new stream of joint capabilities. More...

Function Documentation

ast_sip_create_joint_call_cap()

struct ast_format_cap * ast_sip_create_joint_call_cap	(	const struct ast_format_cap *	remote,
		struct ast_format_cap *	local,
		enum ast_media_type	media_type,
		struct ast_flags	codec_pref
	)

Create joint capabilities.

Since

18.0.0

Creates a list of joint capabilities between the given remote capabilities, and local ones. "local" and "remote" reference the values in ast_sip_call_codec_pref.

Parameters

remote	The "remote" capabilities
local	The "local" capabilities
media_type	The media type
codec_pref	One or more of enum ast_sip_call_codec_pref

Return values

A	pointer to the joint capabilities (which may be empty). NULL will be returned only if no memory was available to allocate the structure.

Note

Returned object's reference must be released at some point,

Definition at line 65 of file pjsip_session_caps.c.

{
    struct ast_format_cap *joint = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
    struct ast_format_cap *local_filtered = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
    struct ast_format_cap *remote_filtered = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 
    if (!joint || !local_filtered || !remote_filtered) {
        ast_log(LOG_ERROR, "Failed to allocate %s call offer capabilities\n",
                ast_codec_media_type2str(media_type));
        ao2_cleanup(joint);
        ao2_cleanup(local_filtered);
        ao2_cleanup(remote_filtered);
        return NULL;
    }
 
    ast_format_cap_append_from_cap(local_filtered, local, media_type);
 
    /* Remote should always be a subset of local, as local is what defines the underlying
     * permitted formats.
     */
    ast_format_cap_get_compatible(remote, local_filtered, remote_filtered);
 
    if (ast_sip_call_codec_pref_test(codec_pref, LOCAL)) {
        if (ast_sip_call_codec_pref_test(codec_pref, INTERSECT)) {
            ast_format_cap_get_compatible(local_filtered, remote_filtered, joint); /* Get common, prefer local */
        } else {
            ast_format_cap_append_from_cap(joint, local_filtered, media_type); /* Add local */
            ast_format_cap_append_from_cap(joint, remote_filtered, media_type); /* Then remote */
        }
    } else {
        if (ast_sip_call_codec_pref_test(codec_pref, INTERSECT)) {
            joint = remote_filtered; /* Get common, prefer remote - as was done when filtering initially */
            remote_filtered = NULL;
        } else {
            ast_format_cap_append_from_cap(joint, remote_filtered, media_type); /* Add remote */
            ast_format_cap_append_from_cap(joint, local_filtered, media_type); /* Then local */
        }
    }
 
    ao2_ref(local_filtered, -1);
    ao2_cleanup(remote_filtered);
 
    if (ast_format_cap_empty(joint)) {
        return joint;
    }
 
    if (ast_sip_call_codec_pref_test(codec_pref, FIRST)) {
        /*
         * Save the most preferred one. Session capabilities are per stream and
         * a stream only carries a single media type, so no reason to worry with
         * the type here (i.e different or multiple types)
         */
        struct ast_format *single = ast_format_cap_get_format(joint, 0);
        /* Remove all formats */
        ast_format_cap_remove_by_type(joint, AST_MEDIA_TYPE_UNKNOWN);
        /* Put the most preferred one back */
        ast_format_cap_append(joint, single, 0);
        ao2_ref(single, -1);
    }
 
    return joint;
}

References ao2_cleanup, ao2_ref, ast_codec_media_type2str(), ast_format_cap_alloc, ast_format_cap_append, ast_format_cap_append_from_cap(), ast_format_cap_empty(), AST_FORMAT_CAP_FLAG_DEFAULT, ast_format_cap_get_compatible(), ast_format_cap_get_format(), ast_format_cap_remove_by_type(), ast_log, AST_MEDIA_TYPE_UNKNOWN, ast_sip_call_codec_pref_test, LOG_ERROR, and NULL.

Referenced by ast_sip_session_create_joint_call_cap(), ast_sip_session_create_joint_call_stream(), and test_create_joint().

ast_sip_session_create_joint_call_cap()

struct ast_format_cap * ast_sip_session_create_joint_call_cap	(	const struct ast_sip_session *	session,
		enum ast_media_type	media_type,
		const struct ast_format_cap *	remote
	)

Create joint capabilities.

Since

18.0.0

Creates a list of joint capabilities between the given session's local capabilities, and the remote capabilities. Codec selection is based on the session->endpoint's codecs, the session->endpoint's codec call preferences, and the "remote" capabilities passed by the core (for outgoing calls) or created by the incoming SDP (for incoming calls).

Parameters

session	The session
media_type	The media type
remote	Capabilities received in an SDP offer or from the core

Return values

A	pointer to the joint capabilities (which may be empty). NULL will be returned only if no memory was available to allocate the structure.

Note

Returned object's reference must be released at some point,

Definition at line 151 of file pjsip_session_caps.c.

{
    struct ast_format_cap *joint = ast_sip_create_joint_call_cap(remote,
        session->endpoint->media.codecs, media_type,
        session->call_direction == AST_SIP_SESSION_OUTGOING_CALL
                ? session->endpoint->media.outgoing_call_offer_pref
                : session->endpoint->media.incoming_call_offer_pref);
 
    log_caps(LOG_DEBUG, session, media_type, session->endpoint->media.codecs, remote, joint);
 
    return joint;
}

References ast_sip_create_joint_call_cap(), AST_SIP_SESSION_OUTGOING_CALL, log_caps(), LOG_DEBUG, and session.

Referenced by set_incoming_call_offer_cap().

ast_sip_session_create_joint_call_stream()

struct ast_stream * ast_sip_session_create_joint_call_stream	(	const struct ast_sip_session *	session,
		struct ast_stream *	remote
	)

Create a new stream of joint capabilities.

Since

18.0.0

Creates a new stream with capabilities between the given session's local capabilities, and the remote stream's. Codec selection is based on the session->endpoint's codecs, the session->endpoint's codec call preferences, and the stream passed by the core (for outgoing calls) or created by the incoming SDP (for incoming calls).

Parameters

session	The session
remote	The remote stream

Return values

A	pointer to a new stream with the joint capabilities (which may be empty), NULL will be returned only if no memory was available to allocate the structure.

Definition at line 130 of file pjsip_session_caps.c.

{
    struct ast_stream *joint_stream = ast_stream_clone(remote_stream, NULL);
    const struct ast_format_cap *remote = ast_stream_get_formats(remote_stream);
    enum ast_media_type media_type = ast_stream_get_type(remote_stream);
 
    struct ast_format_cap *joint = ast_sip_create_joint_call_cap(remote,
        session->endpoint->media.codecs, media_type,
        session->call_direction == AST_SIP_SESSION_OUTGOING_CALL
                ? session->endpoint->media.outgoing_call_offer_pref
                : session->endpoint->media.incoming_call_offer_pref);
 
    ast_stream_set_formats(joint_stream, joint);
    ao2_cleanup(joint);
 
    log_caps(LOG_DEBUG, session, media_type, session->endpoint->media.codecs, remote, joint);
 
    return joint_stream;
}

References ao2_cleanup, ast_sip_create_joint_call_cap(), AST_SIP_SESSION_OUTGOING_CALL, ast_stream_clone(), ast_stream_get_formats(), ast_stream_get_type(), ast_stream_set_formats(), log_caps(), LOG_DEBUG, NULL, and session.

Referenced by ast_sip_session_create_outgoing().