EN 中文

LiteRtLm_DestroyEngine

引擎析构函数。彻底释放 GPU 缓冲区、模型权重内存及相关线程池。确保不留任何内存死区。

01. 级联销毁时序

graph TD Engine[Engine Handle] -->|Destroy| ConvA[Conversation A] Engine -->|Destroy| ConvB[Conversation B] subgraph Resource_Free [资源回收] VRAM[释放模型 VRAM 权重区] KV[销毁全局 KV Cache 池] Thread[终结推理后台线程] end Engine --> Resource_Free

句柄失效警告： 一旦调用 DestroyEngine，所有基于此引擎创建的会话指针 (conv_ptr) 将变为野指针。在调用此函数前，必须停止所有正在进行的推理任务。

02. 参数定义

void LiteRtLm_DestroyEngine(void* engine_ptr);

参数名称	职责说明
`engine_ptr`	要销毁的引擎句柄。调用后，该指针不再可用。

03. 资源回收建议

在虚幻引擎中，建议在 EndPlay 或 BeginDestroy 阶段调用此接口。由于其涉及 GPU 资源的强制同步回收，建议在非主线程执行。

// UE5 子系统清理示例
void UMyAiSubsystem::Deinitialize() {
    if (EngineHandle) {
        LiteRtLm_DestroyEngine(EngineHandle);
        EngineHandle = nullptr;
    }
    Super::Deinitialize();
}