51 lines
1.3 KiB
Markdown
51 lines
1.3 KiB
Markdown
|
# D3D12Texture::InitializeFromExisting
|
|||
|
|
|
|||
|
|
## 函数签名
|
|||
|
|
|
|||
|
|
```cpp
|
|||
|
|
bool InitializeFromExisting(ID3D12Resource* resource);
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 中文描述
|
|||
|
|
|
|||
|
|
从已存在的 D3D12 纹理资源初始化纹理包装类，不分配新资源。此方法用于包装外部创建的纹理资源，例如从文件系统加载的纹理或与其他 API 共享的资源。
|
|||
|
|
|
|||
|
|
## 参数
|
|||
|
|
|
|||
|
|
| 参数 | 类型 | 描述 |
|
|||
|
|
|------|------|------|
|
|||
|
|
| `resource` | `ID3D12Resource*` | 已存在的 D3D12 纹理资源指针，不能为 nullptr |
|
|||
|
|
|
|||
|
|
## 返回值
|
|||
|
|
|
|||
|
|
`bool` - 初始化是否成功。如果 `resource` 为 nullptr，返回 false。
|
|||
|
|
|
|||
|
|
## 线程安全
|
|||
|
|
|
|||
|
|
非线程安全，请确保在单线程环境中调用。
|
|||
|
|
|
|||
|
|
## 复杂度
|
|||
|
|
|
|||
|
|
O(1)
|
|||
|
|
|
|||
|
|
## 示例
|
|||
|
|
|
|||
|
|
```cpp
|
|||
|
|
ComPtr<ID3D12Resource> externalResource;
|
|||
|
|
// 外部创建或获取的 D3D12 资源
|
|||
|
|
device->CreateReservedResource(&desc, initialState, nullptr, IID_PPV_ARGS(&externalResource));
|
|||
|
|
|
|||
|
|
D3D12Texture texture;
|
|||
|
|
if (texture.InitializeFromExisting(externalResource.Get())) {
|
|||
|
|
// 成功包装外部资源
|
|||
|
|
// 注意：外部资源的管理责任保持不变
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 相关文档
|
|||
|
|
|
|||
|
|
- [D3D12Texture](texture.md) - 类总览
|
|||
|
|
- [Initialize](initialize.md) - 创建新纹理
|
|||
|
|
- [InitializeFromData](initialize-from-data.md) - 从数据初始化
|
|||
|
|
- [InitializeDepthStencil](initialize-depth-stencil.md) - 初始化深度模板纹理
|