XCEngine/docs/api/rhi/pipeline-state/get-native-handle.md

# RHIPipelineState::GetNativeHandle

```cpp
virtual void* GetNativeHandle() = 0;
```

获取底层图形 API 的原生句柄。此方法返回的句柄类型取决于具体实现：

- **D3D12**: `ID3D12PipelineState*`
- **OpenGL**: `GLuint`（管线对象 ID）
- **Vulkan**: `VkPipeline`
- **Metal**: `id<MTLRenderPipelineState>`

**参数：** 无

**返回：** `void*` - 指向底层图形 API 管线状态对象的指针

**线程安全：** ❌

**复杂度：** O(1)

**示例：**

```cpp
#include "XCEngine/RHI/RHIPipelineState.h"
#include "XCEngine/RHI/RHIEnums.h"

void InspectNativeHandle(RHIPipelineState* pipeline) {
    void* handle = pipeline->GetNativeHandle();
    
    PipelineType type = pipeline->GetType();
    
    if (type == PipelineType::Graphics && handle) {
        // D3D12: ID3D12PipelineState* d3d12Pipeline = static_cast<ID3D12PipelineState*>(handle);
        // OpenGL: GLuint glPipeline = static_cast<GLuint>(reinterpret_cast<uintptr_t>(handle));
    }
}
```

## 相关文档

- [RHIPipelineState](pipeline-state.md) - 返回类总览
- [RHIPipelineState::GetType](get-type.md) - 获取管线类型