跳转至

DLLGetParameterTable

函数 DLLGetParameterTable 下载控制器完整参数表元数据(parametersInfo.xml 文本投影,含 csv_hash,用于参数树构建与固件/SDK 偏差检测)。

所属:C/C++ API 函数索引

C/C++

ErrorCode DLLGetParameterTable(INT_PTR hClientHandle, char* outXml, int* inOutXmlLength);

C#

.NET SDK 无需直接调用:Controller.Connect() 连接时自动获取参数表(内部功能)。

参数

hClientHandle (INT_PTR)

客户端会话句柄,由 DLLSysConnect 获取。

outXml (char*)

输出。接收 parametersInfo.xml 文本缓冲区(可传 NULL,仅查询所需长度)。

inOutXmlLength (int*)

输入/输出。传入缓冲区容量(字符数);返回时写入实际所需长度(含终止 \0)。缓冲区不足时返回 StringOverflow 并写入所需长度。

返回值

返回 ErrorCodeNoError (0) 表示成功,StringOverflow 表示缓冲区不足(可按所需长度重分配后重试),详见 SDK 发布头 ErrorCode.h。

说明

参数表为控制器侧运行时元数据权威;SDK 通过比对其中的 csv_hash 检测固件与 SDK 参数定义是否偏差。

示例

char* xml = NULL;  int len = 0;
if (DLLGetParameterTable(handle, NULL, &len) == StringOverflow) {
    xml = (char*)malloc(len);
    DLLGetParameterTable(handle, xml, &len);
}

相关函数