---
title: KmlMgMatrixSetValues
description: "为矩阵类型填入数值。"
url: https://www.hikunpeng.com/document/detail/zh/kunpenghpcs/hpckit/devg/kunpengaccel_kml_0967.html
sourcePath: /source/zh/kunpenghpcs/hpckit/devg/kunpengaccel_kml_0967.html
indexId: 09d00c63ca1adeeb152ed2f68fcd430f4f2faa58605a9478036a000d89df2aa161
---
# KmlMgMatrixSetValues

为矩阵类型填入数值。

指定的矩阵数值应当与创建该矩阵句柄时指定的非零元结构对应，该接口应用于矩阵结构不变但值变化的场景。通过该接口更新values数组后，原values数组空间可释放。


#### 接口定义

C Interface：

KmlMgStatus KmlMgMatrixSetValues(KmlMgMatrixH matrix, void* values);


#### 参数

| 参数名 | 类型 | 描述 | 输入/输出 |
| --- | --- | --- | --- |
| matrix | KmlMgMatrixH | 由KmlMgMatrixCreate函数创建的矩阵句柄 | 输入/输出 |
| values | void \* | 矩阵数值数组 | 输入 |


#### 返回值

| 返回值 | 类型 | 描述 |
| --- | --- | --- |
| KML\_MG\_OK | int | 正常执行 |
| KML\_MG\_ERR\_INVALID\_PARAM | int | 参数无效 |
| KML\_MG\_ERR\_UNSUPPORTED | int | 暂不支持的功能 |
| KML\_MG\_ERR\_NO\_MEMORY | int | 分配内存失败 |
| KML\_MG\_ERR\_EXCEEDS\_LIMIT | int | 超过设置限制 |
| KML\_MG\_ERR\_INCOMPATIBLE | int | 版本不兼容 |
| KML\_MG\_ERR\_NO\_REQUIRED\_FIELD | int | 没设置必填字段 |
| KML\_MG\_ERR\_UNKNOWN\_TYPE | int | 未知的类型 |
| KML\_MG\_ERR\_THIRD\_PART | int | 内部调用第三方错误 |
| KML\_MG\_ERR\_INCONSISTENT | int | 传递信息不一致 |
| KML\_MG\_ERR\_UNEXPECTED\_CALL\_ORDER | int | 预期之外的调用顺序 |
| KML\_MG\_ERR\_MATRIX\_VALUE\_IS\_NULL | int | 矩阵值为空 |
| KML\_MG\_ERR\_NO\_RESOURCE | int | 资源未就绪 |


#### 依赖

#include "mg.h"

示例代码请参见示例。