windows 下VLC--LIBVLC API解析（六）----事件相关API

引文

LIBVLC API解析系列文章的每一篇都尽量将相关联的API放在一起讲，随着学习的深入将不断更新本文，如若转载请保证文章完整性及保留博客地址。

这是LIBVLC API解析系列的第二篇，主要介绍VLC事件相关API。

 

改定履历

2010-12-18---------------------------新建文档

正文

说明:一些libvlc对象,如libvlc实例,libvlc播放器会产生异步信号,每一个对象都提供有事件管理器.可以将相应对象事件关联到对应libvlc对象的事件管理器处理或取消关联事件管理器.

相关结构

事件管理器:事件管理器属于一个libvlc对象,管理器可以从对象处接收事件信号 typedef struce libvlc_event_manager_t libvlc_event_manager_t;---------事件管理器结构

struct libvlc_event_t;------------------------------------------------事件结构

typedef int libvlc_event_type_t;--------------------------------------事件类型结构typedef void(*libvlc_callback_t)(const struct libvlc_event_t*,void*)--事件回调函数

API

• 注册事件管理器 VLC_PUBLIC_API int libvlc_event_attach ( libvlc_event_manager_t *p_event_manager, libvlc_event_type_t i_event_type, libvlc_callback_t f_callback, void *user_data); param: p_event_manager:要绑定的事件管理器 i_event_type: 事件类型 f_callback:回调函数指针 user_data:用户提供的数据,由事件带回
• 注销事件管事器 VLC_PUBLIC_API void libvlc_event_detach ( libvlc_event_manager_t *p_event_manager, libvlc_event_type_t i_event_type, libvlc_callback_t f_callback, void *p_user_data); param: p_event_manager:要绑定的事件管理器 i_event_type: 事件类型 f_callback:回调函数指针 user_data:用户提供的数据,由事件带回
• 其他

1. 获取事件类型名 VLC_PUBLIC_API const char * libvlc_event_type_name (libvlc_event_type_t event_type); param: event_type:事件类型 2. 获取播放器事件管理器 VLC_PUBLIC_API libvlc_event_manager_t * libvlc_media_player_event_manager (libvlc_media_player_t *p_mi); Param: p_mi : Media Player return: 返回p_mi关联的事件管理器 3. 获取媒体描述符对象事件管理器 VLC_PUBLIC_API libvlc_event_manager_t * libvlc_media_event_manager (libvlc_media_t * p_md); 4. 获取媒体服务discover对象事件管理器 VLC_PUBLIC_API libvlc_event_manager_t * libvlc_media_discoverer_event_manager (libvlc_media_discoverer_t * p_mdis); 5. 获取媒体列表实例的事件管理器 VLC_PUBLIC_API libvlc_event_manager_t * libvlc_media_list_event_manager (libvlc_media_list_t *p_ml); param: p_ml : 媒体列表实例 6.获取VLM媒体事件管理器 VLC_PUBLIC_API libvlc_event_manager_t * libvlc_vlm_get_event_manager (libvlc_instance_t *p_instance); Param: P_instance : libvlc实例

注意

通常,我们在"Get"之 后要"Release",比如Windows API之GetDC(),相应的ReleaseDC等,在这里对于事件管理器的获取也有一个相应的"Release".

void libvlc_event_manager_release(libvlc_event_manager_t * p_em );

但是,我们并不需要显示的调用该方法,因为"对于一些LIBVLC对象,其结构里就有'事件管理器'----

libvlc_event_manager_t * p_event_manager;

在释放或销毁对象的时候，该方法会被调用以同时销毁相应对象的＇事件管理器＇＂，例如：在调用libvlc_media_player_release()释放媒体播放器时就会调用该方法释放媒体播放器事件管理器．