清除散列读准备的数据 - DmaScatterClear
函数简介
清除散列读句柄中已准备的所有数据，可以重新准备新的地址。(高级版功能,普通版无法使用)
接口名称
DmaScatterClear
DLL调用
int32_t OLA_CALL_TYPE DmaScatterClear(int64_t instance, int64_t scatterHandle);
参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| instance | 长整数型 | OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。 |
| scatterHandle | 长整数型 | 散列句柄，由 DmaScatterCreate 返回 |
示例
// 第一批地址
DmaScatterPrepare(instance, scatterHandle, 0x400000, 4);
DmaScatterExecute(instance, scatterHandle);
// 读取数据...
// 清除数据，准备新的地址
DmaScatterClear(instance, scatterHandle);
DmaScatterPrepare(instance, scatterHandle, 0x500000, 4);
DmaScatterExecute(instance, scatterHandle);
返回值
整数型：1 成功，0 失败。
注意事项
- 清除所有已准备的地址和读取结果
- 句柄仍然有效，可以继续使用