XCEngine/docs/api/rhi/sampler/get-native-handle.md

# RHISampler::GetNativeHandle

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

获取底层图形 API 的原生句柄。该方法返回采样器在对应图形 API 中的原生对象指针或句柄，可用于调试或高级图形 API 互操作。

**参数：** 无

**返回：** 指向原生图形 API 采样器对象的 void 指针，具体类型取决于底层实现（D3D11: `ID3D11SamplerState*`，D3D12: `D3D12_GPU_VIRTUAL_ADDRESS` 或 `ID3D12Resource*`，Vulkan: `VkSampler`）

**线程安全：** ❌

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

**示例：**

```cpp
#include "XCEngine/RHI/RHISampler.h"

class MySampler : public XCEngine::RHI::RHISampler {
public:
    void Shutdown() override { }
    void Bind(unsigned int unit) override { }
    void Unbind(unsigned int unit) override { }
    void* GetNativeHandle() override { return reinterpret_cast<void*>(m_nativeHandle); }
    unsigned int GetID() override { return 0; }

private:
    uint64_t m_nativeHandle = 0x12345678;
};

void Example() {
    MySampler sampler;
    void* handle = sampler.GetNativeHandle();
    if (handle != nullptr) {
        // 使用原生句柄进行调试或高级操作
    }
}
```

## 相关文档

- [RHISampler 总览](sampler.md) - 返回类总览
- [RHISampler::GetID](get-id.md) - 获取采样器 ID