创建散列读句柄 - DmaScatterCreate

函数简介

创建散列读句柄，用于批量读取多个内存地址的数据，提高读取效率。(高级版功能,普通版无法使用)

接口名称

DmaScatterCreate

DLL调用

int64_t OLA_CALL_TYPE DmaScatterCreate(int64_t instance, int64_t deviceId, int32_t pid);

参数说明

参数名	类型	说明
instance	长整数型	OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
deviceId	长整数型	设备ID
pid	整数型	进程 PID

示例

int64_t scatterHandle = DmaScatterCreate(instance, deviceId, 1234);
if (scatterHandle > 0) {
    DmaScatterPrepare(instance, scatterHandle, 0x400000, 4);
    DmaScatterPrepare(instance, scatterHandle, 0x400010, 4);
    DmaScatterExecute(instance, scatterHandle);
    // 读取数据...
    DmaScatterClose(instance, scatterHandle);
}

返回值

长整数型：成功返回散列句柄 (>0)，失败返回 0。