4 * Copyright (c) 2000 - 2011 Samsung Electronics Co., Ltd. All rights reserved.
6 * Contact: JongHyuk Choi <jhchoi.choi@samsung.com>, YeJin Cho <cho.yejin@samsung.com>,
7 * YoungHwan An <younghwan_.an@samsung.com>
9 * Licensed under the Apache License, Version 2.0 (the "License");
10 * you may not use this file except in compliance with the License.
11 * You may obtain a copy of the License at
13 * http://www.apache.org/licenses/LICENSE-2.0
15 * Unless required by applicable law or agreed to in writing, software
16 * distributed under the License is distributed on an "AS IS" BASIS,
17 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
18 * See the License for the specific language governing permissions and
19 * limitations under the License.
23 #ifndef __MM_PLAYER_ATTRS_H__
24 #define __MM_PLAYER_ATTRS_H__
31 * This function set values of attributes.
33 * @param[in] handle Handle of player.
34 * @param[in] err_atr_name Name of attribute that is failed (NULL can be set if it's not require to check. )
35 * @param[in] attribute_name Name of the first attribute to set
36 * @param[in] args_list List of attributes and values
37 * @return This function returns zero on success, or negative value with error code.
39 * @see _mmplayer_get_attribute()
42 int _mmplayer_set_attribute(MMHandleType handle, char **err_atr_name, const char *attribute_name, va_list args_list);
44 * This function get values of attributes.
46 * @param[in] handle Handle of player.
47 * @param[in] err_atr_name Name of attribute that is failed (NULL can be set if it's not require to check. )
48 * @param[in] attribute_name Name of the first attribute to set
49 * @param[in] args_list List of attributes and values
50 * @return This function returns zero on success, or negative value with error code.
52 * @see _mmplayer_set_attribute()
55 int _mmplayer_get_attribute(MMHandleType handle, char **err_atr_name, const char *attribute_name, va_list args_list);
57 * This function get configuration values of attribute.
59 * @param[in] handle Handle of player.
60 * @param[in] attribute_name Name of the first attribute to set
61 * @param[in] info Configuration values
62 * @return This function returns zero on success, or negative value with error code.
67 int _mmplayer_get_attributes_info(MMHandleType handle, const char *attribute_name, MMPlayerAttrsInfo *info);
69 * This function allocates structure of attributes and sets initial values.
71 * @param[in] handle Handle of player.
72 * @return This function returns allocated structure of attributes.
74 * @see _mmplayer_deconstruct_attribute()
77 MMHandleType _mmplayer_construct_attribute(MMHandleType handle);
79 * This function release allocated attributes.
81 * @param[in] handle Handle of player.
82 * @return This function returns true on success or false on failure.
84 * @see _mmplayer_construct_attribute()
87 bool _mmplayer_deconstruct_attribute(MMHandleType handle);
93 #endif /* __MM_PLAYER_ATTRS_H__ */