Skip to main content
创建保留但尚未映射到堆中任何页面的资源。

语法

参数

pDesc [in]
类型:const D3D12_RESOURCE_DESC *
指向 D3D12_RESOURCE_DESC 结构体的指针,该结构体描述资源。 InitialState [in]
类型:D3D12_RESOURCE_STATES
资源的初始状态,为 D3D12_RESOURCE_STATES 枚举常量的按位 OR 组合。 pOptimizedClearValue [in, optional]
类型:const D3D12_CLEAR_VALUE *
指定 D3D12_CLEAR_VALUE 结构体,该结构体描述清除颜色的默认值。 pOptimizedClearValue 指定进行清除操作时最优的值。当创建的资源是带有 D3D12_RESOURCE_FLAG_ALLOW_RENDER_TARGETD3D12_RESOURCE_FLAG_ALLOW_DEPTH_STENCIL 标志的纹理时,您应选择最常用于清除操作的值。您可以使用其他值调用清除操作,但这些操作不会像值与传递给资源创建的值相匹配时那么高效。 当使用 D3D12_RESOURCE_DIMENSION_BUFFER 时,必须将 pOptimizedClearValue 设置为 nullptr riid [in]
类型:const IID &
要在 ppvResource 中返回的资源接口的全局唯一标识符 (GUID) 的引用。请参阅 备注 虽然 riidResource 最常是 ID3D12ResourceGUID,但它也可以是任何接口的 GUID。如果资源对象不支持此 GUID 的接口,则创建失败并返回 E_NOINTERFACE ppvResource [out, optional]
类型:void **
可选指针,指向接收所创建资源对象的所请求接口指针的内存块。 ppvResource 可以为 nullptr,以启用功能测试。当 ppvResourcenullptr 时,不会创建对象,并且当 pDesc 有效时返回 S_FALSE

返回值

类型:HRESULT 如果函数成功,则返回 S_OK。否则,返回 HRESULT 错误代码 有关其他可能的返回值,请参阅 Direct3D 12 返回代码

备注

CreateReservedResource 等效于 Direct3D 11 中的 D3D11_RESOURCE_MISC_TILED。它创建仅具有虚拟内存的资源,没有后备存储。 您需要使用 CopyTileMappingsUpdateTileMappings 将资源映射到物理内存(即映射到堆)。 只有在适配器支持平铺资源层级 1 或更高时,才能创建这些资源类型。平铺资源层级定义访问未映射到堆的资源时的行为。

要求

头文件: d3d12_xs.h 或 d3d12_x.h
库: d3d12_xs.lib 或 d3d12_x.lib
支持的平台:XBOX Series 主机和 XBOX One 系列

另请参阅

CreateCommittedResource CreatePlacedResource ID3D12Device
最后修改于 2026年8月24日