三 回调函数

所谓回调函数（call-back），就是不被程序员调用而是被其他函数或过程调用的函数。通常利用函数指针实现。回调函数一般都具有指定的参数表格式以便正确地分配地址。

madlib开放给用户的唯一接口就是6个回调函数，这6个回调函数都是以enum mad_flow为返回值。enum mad_flow ，这个枚举在头文件decode.h和mad.h中均有定义：

enum mad_flow { MAD_FLOW_CONTINUE = 0x0000, /* continue normally */ MAD_FLOW_STOP = 0x0010, /* stop decoding normally */ MAD_FLOW_BREAK = 0x0011, /* stop decoding and signal an error */ MAD_FLOW_IGNORE = 0x0020 /* ignore the current frame */ };

解码器每次调用回调函数后都会检查返回值，根据返回值决定下一个动作。最基本的解码器至少要实现6个回调函数中的两个——input（decoder_init函数的第三个参数）和output(decoder_init函数的第六个参数)。其中input回调函数在解码器开始运行前将mp3文件在内存中镜像的起始指针和结束指针传递给mad_stream，然后不再起作用(为简单起见，这里使输入的mp3文件在一开始就全部映射进内存，实际当中input回调函数可以只将部分mp3帧映射进内存缓冲，而后在解码过程中被反复调用来重新填充“Refill”缓冲区)；而output回调函数会在整个解码过程中被反复调用，来处理PCM的最终输出。