中文
注册
我要评分
文档获取效率
文档正确性
内容完整性
文档易理解
在线提单
论坛求助

GSMHR

将PCM格式音频数据流编码成GSMHR格式音频数据流。

该函数调用流程如下:

  1. 获取编码需要申请的内存大小dstBufLen。
  2. 调用HMPPA_Gsmhr_EncodeInit_16s8u初始化HmppaGsmhrEncodePolicy_16s结构体。
  3. 调用主函数HMPPA_Gsmhr_Encode_16s8u解码。
  4. 最后调用HMPPA_Gsmhr_EncodeRelease_16s8u释放HmppaGsmhrEncodePolicy_16s结构体所包含的内存。

函数接口声明如下:

  • 获取编码需要申请的内存大小

    HmppResult HMPPA_Gsmhr_GetEncodeDstBufLen_16s8u(int32_t len, int32_t *dstBufLen);

  • 初始化函数:

    HmppResult HMPPA_Gsmhr_EncodeInit_16s8u(HmppaGsmhrEncodePolicy_16s **policy);

  • 编码函数:

    HmppResult HMPPA_Gsmhr_Encode_16s8u(const int16_t *src, int32_t len, int32_t dtx, uint8_t *dst, HmppaGsmhrEncodePolicy_16s *policy, int64_t *bytesConsumed, int32_t *bytesEncoded);

  • 释放函数:

    HmppResult HMPPA_Gsmhr_EncodeRelease_16s8u(HmppaGsmhrEncodePolicy_16s *policy);

参数

参数名

描述

取值范围

输入/输出

src

指向待编码的PCM码流指针。

非空

输入

len

待编码PCM码流长度(以字节为单位)。

(0, INT_MAX]

输入

dtx

是否开启DTX(非连续传输)功能的标志。

  • 0:关闭DTX
  • 1:开启DTX

输入

dst

指向目的向量的指针。

非空

输出

policy

指向GSMHR结构体的指针。

非空

输入/输出

bytesConsumed

指向实际编码消耗的长度(以字节为单位)。

[0, len]

输出

bytesEncoded

指向实际编码输出的长度(以字节为单位)。

[0, 理论编码len后输出的字节数]

输出

dstBufLen

指向目的向量需要的长度(以双字节为单位)。

非空

输出

返回值

  • 成功:返回HMPP_STS_NO_ERR
  • 失败:返回错误码。

错误码

错误码

描述

HMPP_STS_NULL_PTR_ERR

指针参数中包含空指针。

HMPP_STS_SIZE_ERR

len不为正数。

HMPP_STS_SIZE_WRN

src未全部编码。

示例

#include<stdlib.h>
#include<stdio.h>
#include"hmppa.h"
#define ONE_FRAME_GSM 14
#define ONE_FRAME_PCM 160
int main(int argc, char* argv[])
{
    if (argc <3) {
        printf("%s in.pcm out.gsmhr\n", argv[0]);
        return 0;
    }
    FILE *file =fopen(argv[1], "rb");
    if (file ==NULL) {
        printf("Open File %s Failed\n", argv[1]);
        return 0;
    }
    fseek(file, 0, SEEK_END);
    int32_t srcLen =ftell(file) / 2;
    int32_t dstLen;
    HMPPA_Gsmhr_GetEncodeDstBufLen_16s8u(srcLen, &dstLen);
    fseek(file, 0, SEEK_SET);
    short src[srcLen];
    unsigned char rb[dstLen];
    HmppaGsmhrEncodePolicy_16s *policy;
    HMPPA_Gsmhr_EncodeInit_16s8u(&policy);
    FILE *out = fopen(argv[2], "wb");

    fread(src, sizeof(short), srcLen, file);
    long int bytesConsumed;
    int bytesEncoded;
    int dtx = 1;
    int res = HMPPA_Gsmhr_Encode_16s8u(src, srcLen, dtx, rb, policy, &bytesConsumed, &bytesEncoded);
    HMPPA_Gsmhr_EncodeRelease_16s8u(policy);
    printf("bytesConsumed = %d, bytesDecoded = %d, res = %d\n", bytesConsumed, bytesEncoded, res);
    fwrite(rb, sizeof(unsigned char), bytesEncoded, out);
}

运行结果:

bytesConsumed = 50560, bytesDecoded = 2212, res = 0