/**
* fs_session_set_codec_preferences:
* @session: a #FsSession
* @codec_preferences: a #GList of #FsCodec with the desired configuration
* @error: location of a #GError, or %NULL if no error occured
*
* Set the list of desired codec preferences. The user may
* change this value during an ongoing session. Note that doing this can cause
* the codecs to change. Therefore this requires the user to fetch
* the new codecs and renegotiate them with the peers. It is a #GList
* of #FsCodec. The changes are immediately effective.
* The function does not take ownership of the list.
*
* The payload type may be a valid dynamic PT (96-127), %FS_CODEC_ID_DISABLE
* or %FS_CODEC_ID_ANY. If the encoding name is "reserve-pt", then the
* payload type of the codec will be "reserved" and not be used by any
* dynamically assigned payload type.
*
* If the list of specifications would invalidate all codecs, an error will
* be returned.
*
* Returns: %TRUE on success, %FALSE on error.
*/
gboolean
fs_session_set_codec_preferences (FsSession *session,
GList *codec_preferences,
GError **error)
{
FsSessionClass *klass = FS_SESSION_GET_CLASS (session);
if (klass->set_codec_preferences) {
return klass->set_codec_preferences (session, codec_preferences, error);
} else {
g_set_error (error, FS_ERROR, FS_ERROR_NOT_IMPLEMENTED,
"set_codec_preferences not defined in class");
}
return FALSE;
}
/**
* fs_session_set_codec_preferences:
* @session: a #FsSession
* @codec_preferences: (element-type FsCodec) (allow-none): a #GList of #FsCodec with the
* desired configuration
* @error: location of a #GError, or %NULL if no error occured
*
* Set the list of desired codec preferences. The user may
* change this value during an ongoing session. Note that doing this can cause
* the codecs to change. Therefore this requires the user to fetch
* the new codecs and renegotiate them with the peers. It is a #GList
* of #FsCodec. The changes are immediately effective.
* The function does not take ownership of the list.
*
* The payload type may be a valid dynamic PT (96-127), %FS_CODEC_ID_DISABLE
* or %FS_CODEC_ID_ANY. If the encoding name is "reserve-pt", then the
* payload type of the codec will be "reserved" and not be used by any
* dynamically assigned payload type.
*
* If the list of specifications would invalidate all codecs, an error will
* be returned.
*
* Returns: %TRUE on success, %FALSE on error.
*/
gboolean
fs_session_set_codec_preferences (FsSession *session,
GList *codec_preferences,
GError **error)
{
FsSessionClass *klass;
g_return_val_if_fail (session, FALSE);
g_return_val_if_fail (FS_IS_SESSION (session), FALSE);
klass = FS_SESSION_GET_CLASS (session);
if (klass->set_codec_preferences) {
return klass->set_codec_preferences (session, codec_preferences, error);
} else {
GST_WARNING ("set_send_preferences not defined in class");
g_set_error (error, FS_ERROR, FS_ERROR_NOT_IMPLEMENTED,
"set_codec_preferences not defined in class");
}
return FALSE;
}
