77 lines
1.9 KiB
Markdown
77 lines
1.9 KiB
Markdown
# VrShareMem - 跨平台共享内存模块
|
||
|
||
## 概述
|
||
|
||
VrShareMem 是一个跨平台的共享内存模块，支持 Windows 和 Linux 操作系统。提供了统一的接口来创建、管理和操作共享内存区域，支持进程间的数据共享和同步。
|
||
|
||
## 特性
|
||
|
||
- 跨平台支持（Windows/Linux）
|
||
- 统一的接口设计
|
||
- 内置同步机制（std::timed_mutex）
|
||
- 内存边界检查
|
||
- 自动资源管理
|
||
|
||
|
||
|
||
## 使用示例
|
||
|
||
```cpp
|
||
#include "IVrShareMem.h"
|
||
#include "VrError.h"
|
||
|
||
int main() {
|
||
// 创建共享内存实例
|
||
IVrShareMem* sharedMem = CreateShareMemInstance();
|
||
|
||
// 创建共享内存区域
|
||
int ret = sharedMem->CreateOrOpen("test_memory", 1024, true);
|
||
if (ret != SUCCESS) {
|
||
// 错误处理
|
||
DestroyShareMemInstance(sharedMem);
|
||
return -1;
|
||
}
|
||
|
||
// 映射内存
|
||
void* ptr = sharedMem->MapView();
|
||
if (ptr == nullptr) {
|
||
// 错误处理
|
||
sharedMem->Close();
|
||
DestroyShareMemInstance(sharedMem);
|
||
return -1;
|
||
}
|
||
|
||
// 写入数据
|
||
const char* data = "Hello, Shared Memory!";
|
||
sharedMem->WriteData(0, data, strlen(data) + 1);
|
||
|
||
// 读取数据
|
||
char buffer[256];
|
||
int readBytes = sharedMem->ReadData(0, buffer, sizeof(buffer));
|
||
|
||
// 使用锁进行同步
|
||
if (sharedMem->Lock(1000) == SUCCESS) { // 1秒超时
|
||
// 临界区操作
|
||
sharedMem->Unlock();
|
||
}
|
||
|
||
// 清理资源
|
||
sharedMem->Close();
|
||
DestroyShareMemInstance(sharedMem);
|
||
|
||
return 0;
|
||
}
|
||
```
|
||
## 注意事项
|
||
|
||
1. 共享内存名称在同一系统中必须唯一
|
||
2. 创建者进程负责删除共享内存资源
|
||
3. **重要**: 锁机制使用 `std::timed_mutex`，仅适用于同一进程内的线程同步，不支持跨进程同步
|
||
4. 确保在程序退出前调用 `Close()` 方法
|
||
5. Linux 下需要链接 `rt` 库
|
||
|
||
## 依赖
|
||
|
||
- C++11 或更高版本
|
||
- Windows: kernel32.dll, user32.dll
|
||
- Linux: rt 库 |