DLLGetParameterTable
函数 DLLGetParameterTable 下载控制器完整参数表元数据(parametersInfo.xml 文本投影,含 csv_hash,用于参数树构建与固件/SDK 偏差检测)。
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 并写入所需长度。
返回值
返回 ErrorCode;NoError (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);
}