锁定当前屏幕图像 - LockDisplay

函数简介

锁定当前屏幕图像，启用后截图接口将始终返回锁定时的那一帧图像。

接口名称

LockDisplay

DLL调用

int32_t LockDisplay(int64_t instance, int32_t enable);

参数说明

参数名类型说明
instance长整数型OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
enable整数型锁定标志：0 取消锁定并释放内存、1 锁定当前屏幕图像

示例

int32_t ret = LockDisplay(ola, 1);
if (ret == 1) {
    long img1 = GetScreenDataPtr(ola, 0, 0, 800, 600);
    long img2 = GetScreenDataPtr(ola, 0, 0, 800, 600); // 返回同一帧
    if (img1 != 0) FreeImagePtr(ola, img1);
    if (img2 != 0) FreeImagePtr(ola, img2);
}
LockDisplay(ola, 0); // 取消锁定

返回值

整数型：1 成功，0 失败。

注意事项

  • 锁定后截图接口返回锁定时的图像，而非实时屏幕内容。
  • 不再需要锁定时调用 LockDisplay(instance, 0) 取消锁定以释放内存。
  • 可与 SetSnapCacheTime 配合使用，但应根据需求合理配置。
Last Updated: