通过DMA读取指定地址的字符串 - DmaReadString
函数简介
通过 DMA 读取指定地址的字符串,支持多种字符串编码格式和 CE 地址格式。(高级版功能,普通版无法使用)
接口名称
DmaReadString
DLL调用
OLA_STRING_RETURN OLA_CALL_TYPE DmaReadString(int64_t instance, int64_t deviceId, int32_t pid, OLA_STRING_INPUT addr, int32_t type, int32_t len);
参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| instance | 长整数型 | OLAPlug对象的指针,由 CreateCOLAPlugInterFace 接口生成。 |
| deviceId | 长整数型 | 设备ID |
| pid | 整数型 | 进程 PID |
| addr | 字符串 | 地址,支持 CE 数据格式 |
| type | 整数型 | 字符串类型:0=GBK, 1=Unicode, 2=UTF8 |
| len | 整数型 | 读取长度(字节),0 表示自动判定 |
示例
const char* str = DmaReadString(instance, deviceId, 1234, "0x400000", 0, 0);
if (str != NULL) {
printf("字符串: %s\n", str);
FreeStringPtr(instance, str);
}
返回值
字符串指针,数据格式为 UTF-8 编码的字符串。
返回的字符串指针需要调用 FreeStringPtr 释放内存。
