KmlAmgPrecondQuery
进行预条件子信息查询。
接口定义
C Interface：
KmlAmgStatus KmlAmgPrecondQuery(KmlAmgPrecondH precond, KmlAmgPrecondInfo* info);
参数
参数名 |
类型 |
描述 |
输入/输出 |
|---|---|---|---|
precond |
KmlAmgPrecondH |
预条件子句柄 |
输入 |
info |
KmlAmgPrecondInfo |
用于保存用户查询的预条件子信息结果 |
输入/输出 |
返回值
返回值 |
类型 |
描述 |
|---|---|---|
KMLAMG_SUCCESS |
int |
运行成功 |
KMLAMG_ERR_INVALID_PARAM |
int |
参数无效 |
KMLAMG_ERR_UNSUPPORTED |
int |
功能暂不支持 |
KMLAMG_ERR_NULL_POINTER |
int |
空指针 |
KMLAMG_ERR_NO_REQUIRED_FIELD |
int |
没有设置必需字段 |
KMLAMG_ERR_NO_MEMORY |
int |
内存分配失败 |
KMLAMG_ERR_UNKNOWN_TYPE |
int |
未知的类型 |
KMLAMG_ERR_UNEXPECTED_CALL_ORDER |
int |
预期之外的调用顺序 |
KMLAMG_ERR_NO_RESOURCE |
int |
资源未就绪 |
KMLAMG_ERR_INCONSISTENT |
int |
不同阶段传递的信息不一致 |
KMLAMG_ERR_UNKNOWN_ERROR |
int |
未知错误 |
结构体说明
KmlAmgPrecondInfo结构体描述：
字段名 |
类型 |
描述 |
|---|---|---|
fieldMask |
uint64_t |
配置生效的字段掩码。非0的位代表配置对应字段指定的值，0的位代表使用默认值，暂无可配置的掩码位。 |
perm |
void* |
应用于矩阵的重新分区排列。排列后矩阵的第i行/列对应于原始矩阵的第perm[i]行/列。用户需要分配足够的空间，即N * sizeof(IndexType)。 - N：矩阵的全局维度； - IndexType：依赖预条件子的TyamgIndexType类型，可以是int32_t或int64_t。 |
localBegin |
int64_t |
重排后本进程矩阵的起始行/列索引。 |
依赖
#include "amg4c.h"