使用 Codec Engine 的 API 函数（三）

本文翻译自TI的手册，该手册是学习GPP＋DSP开发的金典文档，希望对各位入门有所帮助，有理解不当之处望请赐教。
 Codec Engine Application Developer User's Guide.pdf (Literature Number: SPRUE67D)
《Codec Engine 应用开发使用手册》           http://blog.csdn.net/dyzok88/article/details/42154487
《第一章 Codec Engine 概要》                http://blog.csdn.net/dyzok88/article/details/42214813
《第二章 Codec Engine 安装和设置》          http://blog.csdn.net/dyzok88/article/details/42278109
《第三章 使用 Codec Engine 的示例应用程序》 http://blog.csdn.net/dyzok88/article/details/42302793

// 正文

第4章 使用 Codec Engine 的 API 函数

4.3 VISA 类: 视频，图像，语音，音频

以下 API 函数被提供给每个 VISA 类的编码器( encoder )和解码器（ decoder ）双方，其中，MOD是模块的前缀：

1. MOD_create. 创建该类型算法的一个实例。 Create an instance of this type of algorithm. 
2. MOD_process. 在此算法的实例上执行 "process" 的方法。
3. MOD_control. 在此算法的实例上执行 "control" 的方法。

4. MOD_delete. 删除此类型算法的指定实例。

4.3.1 VISA API 配置代码

对于应用程序使用的每个 VISA API 模块，你应该包括相应的头文件。例如，下面的语句包括用于音频解码器 API 模块的头文件，目录路径是相对于 CE_INSTALL_DIR/packages 软件包库。

[objc]  view plain copy

1. #include <ti/sdo/ce/audio/auddec.h>  

4.3.2 创建算法实例

在引擎内创建一个算法实例，为合适的VISA 编码器或解码器模块使用 *_create() 函数即可。

[objc]  view plain copy

1. Engine_Handle ce;  
2. AUDDEC_Handle dec;  
3. static String decoderName = "auddec_copy";  
4.   
5. /* allocate and initialize audio decoder on the Engine */  
6. dec = AUDDEC_create(ce, decoderName, NULL);  

在此函数中，第一个参数-ce-是 Engine_Handle 类型，该类型由 Engine_open() 函数返回。

第二个参数－decoderName-是一个字符串，用来标识要创建的算法类型。这些字符串是由系统集成工程师创建的配置文件的一部分。

第三个参数允许你在实例化算法时指定要使用的参数，这些参数控制算法的行为方面。参数的结构体与每个 VISA 编码器或解码器类不同。例如，音频解码器参数结构体如下：

[objc]  view plain copy

1. typedef struct IAUDDEC_Params {  
2.    XDAS_Int32 size;           /* Size of this structure */  
3.    XDAS_Int32 maxSampleRate;  /* Max sampling freq in Hz */  
4.    XDAS_Int32 maxBitrate;  /* Max bit-rate in bits per sec */  
5.    XDAS_Int32 maxNoOfCh;      /* Max number of channels */  
6.    XDAS_Int32 dataEndianness; /* Endianness of input data */