---
title: KmlMgSolverQuery
description: "查询求解器配置信息。"
url: https://www.hikunpeng.com/document/detail/zh/kunpenghpcs/hpckit/devg/kunpengaccel_kml_0976.html
sourcePath: /source/zh/kunpenghpcs/hpckit/devg/kunpengaccel_kml_0976.html
indexId: f5fed8b21e79be96d43995fe9985c431207c016dc745fc9d91cdaf8a29a9c20361
---
# KmlMgSolverQuery

查询求解器配置信息。

#### 接口定义

C Interface：

KmlMgStatus KmlMgSolverQuery(KmlMgSolverH solver, KmlMgSolverInfo* info);


#### 参数

| 参数名 | 类型 | 描述 | 输入/输出 |
| --- | --- | --- | --- |
| solver | KmlMgSolverH | 由KmlMgSolverCreate创建的求解器句柄 | 输入/输出 |
| info | KmlMgSolverInfo\* | 用于保存用户查询的求解器信息结果 | 输出 |


#### 返回值

| 返回值 | 类型 | 描述 |
| --- | --- | --- |
| 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 | 资源未就绪 |


#### 结构体说明

KmlMgSolverInfo

| 字段名 | 字段类型 | 字段说明 |
| --- | --- | --- |
| fieldMask | uint64\_t | 配置生效的字段掩码。非0的位代表配置对应字段指定的值，0的位代表使用默认值，可配置的掩码位请参见具体字段的说明。 |
| ksp | KmlMgSolverKsp | KmlMgSolverOptions的ksp字段，详细说明见KmlMgSolverOptions 掩码位：KML\_MG\_SOLVER\_INFO\_KSP\_TYPE |
| useZeroGuess | bool | KmlMgApplyOptions的useZeroGuess字段，详细说明见KmlMgApplyOptions 掩码位：KML\_MG\_SOLVER\_INFO\_USE\_ZERO\_GUESS |
| toleranceType | KmlMgToleranceType | KmlMgApplyOptions的toleranceType字段，详细说明见KmlMgApplyOptions 掩码位：KML\_MG\_SOLVER\_INFO\_TOLERANCE\_TYPE |
| tolerance | double | KmlMgApplyOptions的tolerance字段，详细说明见KmlMgApplyOptions 掩码位：KML\_MG\_SOLVER\_INFO\_TOLERANCE |
| maxIteration | int64\_t | KmlMgApplyOptions的maxIteration字段，详细说明见KmlMgApplyOptions 掩码位：KML\_MG\_SOLVER\_INFO\_MAX\_ITERATION |
| restartStep | int64\_t | KmlMgApplyOptions的restartStep字段，详细说明见KmlMgApplyOptions，仅当KmlMgSolverOptions.ksp为KML\_MG\_SOLVER\_GCR或KML\_MG\_SOLVER\_GMRES时生效 掩码位：KML\_MG\_SOLVER\_INFO\_RESTART\_STEP |
| solveResi | bool | KmlMgApplyOptions的solveResi字段，详细说明见KmlMgApplyOptions，仅当KmlMgSolverOptions.ksp为KML\_MG\_SOLVER\_GCR时生效 掩码位：KML\_MG\_SOLVER\_INFO\_SOLVE\_RESI |


#### 依赖

#include "mg.h"

示例代码请参见示例。