---
title: aclblasHgemm
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/ascendgraphapi/aclcppdevg_03_0275.html
sourcePath: /source/zh/canncommercial/900/API/ascendgraphapi/aclcppdevg_03_0275.html
indexId: 86bcd5d5e35c4871c17e68d191267a6319e490ec76eaba71980c6fa0afbea52b72
---
# aclblasHgemm

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| Atlas 350 加速卡 | √ |
| Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | √ |
| Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | √ |
| Atlas 200I/500 A2 推理产品 | √ |
| Atlas 推理系列产品 | √ |
| Atlas 训练系列产品 | √ |


#### 功能说明

执行矩阵-矩阵的乘法，C = αAB + βC，输入数据和输出数据的数据类型为aclFloat16(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/runtimeapi/aclcppdevg_03_1347.html)。异步接口。


#### 函数原型

```
aclError aclblasHgemm(aclTransType transA,
aclTransType transB,
aclTransType transC,
int m,
int n,
int k,
const aclFloat16 *alpha,
const aclFloat16 *matrixA,
int lda,
const aclFloat16 *matrixB,
int ldb,
const aclFloat16 *beta,
aclFloat16 *matrixC,
int ldc,
aclComputeType type,
aclrtStream stream)
```


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| transA | 输入 | A矩阵是否转置的标记。类型定义请参见aclTransType。 |
| transB | 输入 | B矩阵是否转置的标记。类型定义请参见aclTransType。 |
| transC | 输入 | C矩阵的标记。类型定义请参见aclTransType。 当前仅支持ACL\_TRANS\_N。 |
| m | 输入 | 矩阵A的行数与矩阵C的行数。 |
| n | 输入 | 矩阵B的列数与矩阵C的列数。 |
| k | 输入 | 矩阵A的列数与矩阵B的行数。 |
| alpha | 输入 | 用于执行乘操作的标量α的指针。类型定义请参见aclFloat16(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/runtimeapi/aclcppdevg\_03\_1347.html)。 |
| matrixA | 输入 | 矩阵A的指针。类型定义请参见aclFloat16(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/runtimeapi/aclcppdevg\_03\_1347.html)。 |
| lda | 输入 | A矩阵的主维，此时选择转置，按行优先，则lda为A的列数。预留参数，当前只能设置为\-1。 |
| matrixB | 输入 | 矩阵B的指针。类型定义请参见aclFloat16(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/runtimeapi/aclcppdevg\_03\_1347.html)。 |
| ldb | 输入 | B矩阵的主维，此时选择转置，按行优先，则ldb为B的列数。 预留参数，当前只能设置为\-1。 |
| beta | 输入 | 用于执行乘操作的标量β的指针。类型定义请参见aclFloat16(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/runtimeapi/aclcppdevg\_03\_1347.html)。 |
| matrixC | 输入&输出 | 矩阵C的指针。类型定义请参见aclFloat16(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/runtimeapi/aclcppdevg\_03\_1347.html)。 |
| ldc | 输入 | C矩阵的主维，预留参数，当前只能设置为\-1。 |
| type | 输入 | 计算精度，默认高精度。类型定义请参见aclComputeType。 |
| stream | 输入 | 执行算子所在的Stream。类型定义请参见aclrtStream(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/runtimeapi/aclcppdevg\_03\_1355.html)。 |


#### 返回值说明

返回0表示成功，返回其他值表示失败，请参见aclError。