---
title: AMRWB
description: "将AMRWB格式音频数据流解码成PCM格式音频数据流，目前仅支持单通道解码。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/2200/accel/kunpengaccel_hmpp_06_0205.html
sourcePath: /source/zh/kunpengboostkithistory/2200/accel/kunpengaccel_hmpp_06_0205.html
indexId: ba12a32f2b90b25a5bb2b78aac11da78f8034a518ff08a16783a194389fada6575
---
# AMRWB

将AMRWB格式音频数据流解码成PCM格式音频数据流，目前仅支持单通道解码。

该函数调用流程如下：

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

函数接口声明如下：

- 获取解码需要申请的内存大小：
  HmppResult HMPPA_Amrwb_GetDecodeDstBufLen_8u16s(const uint8_t *src, int32_t len, int32_t *dstBufLen);

- 初始化函数：
  HmppResult HMPPA_Amrwb_DecodeInit_8u16s(HmppaAmrwbDecodePolicy_16s** policy);

- 解码函数：
  HmppResult HMPPA_Amrwb_Decode_8u16s(uint8_t *src, int32_t len, int16_t *dst, HmppaAmrwbDecodePolicy_16s*policy, int32_t *bytesConsumed, int64_t *byteDecoded);

- 释放函数：
  HmppResult HMPPA_Amrwb_DecodeRelease_8u16s(HmppaAmrwbDecodePolicy_16s* policy);


#### 参数

| 参数名 | 描述 | 取值范围 | 输入/输出 |
| --- | --- | --- | --- |
| src | 指向待解码的AMRWB码流指针。 | 非空 | 输入 |
| len | 待解码数据流长度（以字节为单位）。 | (0, INT\_MAX] | 输入 |
| dst | 指向目的向量的指针。 | 非空 | 输出 |
| policy | 特殊结构体的指针。 | 非空 | 输入/输出 |
| bytesConsumed | 指向实际解码消耗的长度（以字节为单位）。 | [0, len] | 输出 |
| bytesDecoded | 指向实际解码输出的长度（以字节为单位）。 | [0, 理论解码len后输出的字节数] | 输出 |
| dstBufLen | 指向目的向量需要的长度（以双字节为单位）。 | 非空 | 输出 |


#### 返回值

- 成功：返回HMPP_STS_NO_ERR。
- 失败：返回错误码。


#### 错误码

| 错误码 | 描述 |
| --- | --- |
| HMPP\_STS\_NULL\_PTR\_ERR | src、dst、policy中存在空指针。 |
| HMPP\_STS\_MALLOC\_FAILED | 申请内存失败。 |
| HMPP\_STS\_SIZE\_WRN | 输入的数据流未能完全解码。 |
| HMPP\_STS\_HEAD\_ERR | 输入的数据流头信息错误，即非AMRWB音频格式码流。 |


#### 示例

```
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <hmppa.h>
#define FRAMES 158
int main(int argc, char *argv[]) {
FILE* in;
FILE* out;
void *amrwb;
int32_t re;
int32_t bytesConsumed = 0;
int64_t bytesDecoded = 0;
if (argc < 3) {
fprintf(stderr, "%s in.amr out.pcm\n", argv[0]);
return 1;
}
in = fopen(argv[1], "rb");
out = fopen(argv[2], "w+");
if (!in) {
perror(argv[1]);
return 1;
}
fseek(in, 0, SEEK_END);
int32_t srcLen = ftell(in);
fseek(in, 0, SEEK_SET);
int32_t dstLen;
re = HMPPA_Amrnb_GetDecodeDstBufLen_8u16s(src, srcLen, &dstLen);
uint8_t* src = (uint8_t*)malloc(srcLen * sizeof(uint8_t));
int16_t* dst = (int16_t*)malloc(dstLen * sizeof(int16_t));
int32_t n = fread(src, 1, srcLen, in);
if (n != srcLen) {
return -1;
}
re = HMPPA_Amrwb_DecodeInit_8u16s(&amrwb);
if (re != HMPP_STS_NO_ERR) {
return 0;;
}
re = HMPPA_Amrwb_Decode_8u16s(src, srcLen, dst, amrwb, &bytesConsumed, &bytesDecoded);
if (re == HMPP_STS_NO_ERR) {
fwrite(dst, 2, dstLen, out);
printf("SUCCESS: result = %d, bytesConsumed = %d, bytesDecoded = %lld\n", re, bytesConsumed, bytesDecoded);
} else if (re == HMPP_STS_SIZE_WRN) {
fwrite(dst, 2, dstLen, out);
printf("WARNING: result = %d, bytesConsumed = %d, bytesDecoded = %lld\n", re, bytesConsumed, bytesDecoded);
} else {
printf("WRONG: result = %d, bytesConsumed = %d, bytesDecoded = %lld\n", re, bytesConsumed, bytesDecoded);
}
re = HMPPA_Amrwb_DecodeRelease_8u16s(amrwb);
fclose(in);
fclose(out);
return 0;
}
```

运行结果：

```
SUCCESS: result = 0, bytesConsumed = 9647, bytesDecoded = 50560
```