DLLInitializeSystem

函数 DLLInitializeSystem 触发 One 控制器的初始化流程（等效于复位操作），初始化完成后可通过 DLLIsSystemInitialized 查询状态。

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

C/C++

ErrorCode DLLInitializeSystem(INT_PTR hClientHandle, int* outWarnings);

C#

Controller.Connect() 连接时自动完成初始化；Controller.Reset() 重新触发复位/初始化流程。

参数

hClientHandle (INT_PTR)

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

outWarnings (int*)

输出。接收初始化警告位域，每一位对应一种警告条件（0 表示无警告）。具体位定义参见控制器固件文档。

返回值

返回 ErrorCode；NoError (0) 表示初始化成功，正值为错误码，详见 SDK 发布头 ErrorCode.h。可能返回 ResetTimeout、InitializationError 等。

说明

此函数为同步阻塞调用，阻塞时间取决于控制器固件初始化耗时（通常数秒）。建议连接后首先调用此函数，确保控制器处于可用状态。

示例

int warnings = 0;
if (DLLInitializeSystem(handle, &warnings) != NoError) return 1;
if (warnings != 0) printf("Initialized with %d warning(s)\n", warnings);

相关函数

• DLLSysConnect
• DLLIsSystemInitialized