关闭散列读句柄 - DmaScatterClose

函数简介

关闭散列读句柄，释放相关资源。(高级版功能,普通版无法使用)

接口名称

DmaScatterClose

DLL调用

int32_t OLA_CALL_TYPE DmaScatterClose(int64_t instance, int64_t scatterHandle);

参数定义:

instance (长整型数): OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
scatterHandle (长整型数): 散列句柄，由 DmaScatterCreate 返回

示例:

// 创建散列读句柄
int64_t scatterHandle = DmaScatterCreate(instance, deviceId, 1234);

// 准备地址
DmaScatterPrepare(instance, scatterHandle, 0x400000, 4);
DmaScatterPrepare(instance, scatterHandle, 0x400010, 4);

// 执行散列读
DmaScatterExecute(instance, scatterHandle);

// 读取数据...

// 关闭句柄
int32_t result = DmaScatterClose(instance, scatterHandle);
if (result == 1) {
    printf("散列读句柄关闭成功\n");
} else {
    printf("散列读句柄关闭失败\n");
}

返回值

整型数:

1: 成功
0: 失败

参数说明

关闭操作：

释放散列句柄占用的资源
关闭后句柄不再有效
不能再使用该句柄进行操作

应用场景

完成散列读操作后清理资源
释放内存
避免资源泄漏