XCEngine/docs/api/rhi/factory/create-rhi-device-string.md

# RHIFactory::CreateRHIDevice

```cpp
static RHIDevice* CreateRHIDevice(const std::string& typeName);
```

根据指定的 RHI 类型名称创建一个新的 RHI 设备实例。

**参数：**
- `typeName` - RHI 类型的字符串名称，支持的值包括：
  - `"D3D12"` - DirectX 12
  - `"OpenGL"` - OpenGL
  - `"Vulkan"` - Vulkan
  - `"Metal"` - Metal

**返回：** 新创建的 RHIDevice 指针，如果创建失败则返回 nullptr。

**异常：** 无

**线程安全：** ❌ 该方法本身是线程安全的，但返回的 RHIDevice 实例通常不是线程安全的。

**复杂度：** O(n)，其中 n 为 typeName 字符串长度

**示例：**

```cpp
#include "XCEngine/RHI/RHIFactory.h"
#include "XCEngine/RHI/RHIDevice.h"
#include <iostream>

using namespace XCEngine::RHI;

int main() {
    RHIDevice* device = RHIFactory::CreateRHIDevice("Vulkan");
    if (!device) {
        std::cerr << "Failed to create Vulkan device" << std::endl;
        return 1;
    }
    
    RHIDeviceDesc desc;
    if (!device->Initialize(desc)) {
        std::cerr << "Failed to initialize device" << std::endl;
        delete device;
        return 1;
    }
    
    const RHIDeviceInfo& info = device->GetDeviceInfo();
    std::cout << "Device created: " << info.deviceName << std::endl;
    
    device->Shutdown();
    delete device;
    return 0;
}
```

## 相关文档

- [RHIFactory](factory.md) - 返回类总览
- [`CreateRHIDevice(RHIType)`](create-rhi-device-type.md) - 根据枚举类型创建设备