ID3D12Device：：CreatePlacedResource 方法 (d3d12.h)

项目
02/29/2024

创建放置在特定堆中的资源。放置的资源是可用最轻的资源对象，创建和销毁速度最快。

应用程序可以通过重叠堆区域中放置的多个 Direct3D 和保留的资源来重复使用视频内存。 “ 备注 ” (中所述的简单内存重用模型) 存在，以阐明哪些重叠资源在任何给定时间都有效。为了最大化图形工具支持，不支持使用简单模型进行数据继承;不支持细化磁贴和子资源失效。仅发生完全重叠的资源失效。

语法

HRESULT CreatePlacedResource(
  ID3D12Heap                *pHeap,
  UINT64                    HeapOffset,
  const D3D12_RESOURCE_DESC *pDesc,
  D3D12_RESOURCE_STATES     InitialState,
  const D3D12_CLEAR_VALUE   *pOptimizedClearValue,
  REFIID                    riid,
  void                      **ppvResource
);

参数

pHeap

类型：[in] ID3D12Heap*

指向 ID3D12Heap 接口的指针，该接口表示放置资源的堆。

HeapOffset

类型： UINT64

资源偏移量（以字节为单位）。 HeapOffset 必须是资源对齐方式的倍数，而 HeapOffset 加上资源大小必须小于或等于堆大小。必须使用 GetResourceAllocationInfo 来了解纹理资源的大小。

pDesc

类型：[in] const D3D12_RESOURCE_DESC*

指向描述 资源的D3D12_RESOURCE_DESC 结构的指针。

InitialState

类型： D3D12_RESOURCE_STATES

资源的初始状态，作为 D3D12_RESOURCE_STATES 枚举常量的按位 OR 组合。

将资源与D3D12_HEAP_TYPE_UPLOAD堆一起创建时，必须D3D12_RESOURCE_STATE_GENERIC_READInitialState。将资源与D3D12_HEAP_TYPE_READBACK堆一起创建时，必须D3D12_RESOURCE_STATE_COPY_DESTInitialState。

pOptimizedClearValue

类型：[in，可选] const D3D12_CLEAR_VALUE*

指定描述明色默认值的 D3D12_CLEAR_VALUE 。

pOptimizedClearValue 指定清除操作最适合的值。当创建的资源是具有 D3D12_RESOURCE_FLAG_ALLOW_RENDER_TARGET 标志或 D3D12_RESOURCE_FLAG_ALLOW_DEPTH_STENCIL标志的 纹理时，应用程序应选择最常用于调用清除操作的值。

可以使用其他值调用清除操作，但这些操作的效率将不如值与传递到资源创建中的值匹配时那样有效。

pOptimizedClearValue 与 D3D12_RESOURCE_DIMENSION_BUFFER 一起使用时必须为 NULL。

riid

类型： REFIID

资源接口的全局唯一标识符 (GUID) 。这是一个输入参数。

可以使用 __uuidof 宏获取资源接口的 REFIID 或 GUID。例如， __uuidof(ID3D12Resource) 获取资源接口的 GUID 。尽管 riid 通常是 ID3D12Resource 的 GUID ，但它可能是任何接口的任何 GUID。如果资源对象不支持此 GUID 的接口，则创建将失败并 E_NOINTERFACE。

ppvResource

类型：[out，可选] void**

指向内存块的指针，该内存块接收指向资源的指针。 ppvResource 可以为 NULL，以启用功能测试。当 ppvResource 为 NULL 时，将不会创建任何对象，并且当 pResourceDesc 和其他参数有效时，将返回S_FALSE。

返回值

类型： HRESULT

如果没有足够的内存来创建资源，此方法将返回 E_OUTOFMEMORY 。有关其他可能的返回值，请参阅 Direct3D 12 返回代码。

注解

CreatePlacedResource 类似于将保留资源完全映射到堆中的偏移量;但也可以重复使用与堆关联的虚拟地址空间。

与已提交资源相比，已放置资源的创建和销毁权重要轻。这是因为在这些操作期间不会创建或销毁任何堆。此外，与资源创建和销毁相比，放置资源允许更轻量地重复使用内存，也就是说，通过别名和别名屏障重复使用。在同一堆上，多个放置的资源可以同时相互重叠，但一次只能使用一个重叠的资源。

有两种已放置的资源使用语义-简单模型和高级模型。我们建议你选择简单模型 (它在 GPU) 的各种生态系统中最大化图形工具支持，除非你发现你需要应用的高级模型。

简单模型

在此模型中，可以将放置的资源视为处于以下两种状态之一：活动或非活动。 GPU 从非活动资源读取或写入操作无效。放置的资源处于非活动状态创建。

若要激活命令列表中具有别名屏障的资源，应用程序必须在 D3D12_RESOURCE_ALIASING_BARRIER：:p ResourceAfter 中传递资源。 pResourceBefore 可以在激活期间保留 NULL。与激活的资源共享物理内存的所有资源现在都变为非活动状态，其中包括重叠的放置资源和保留的资源。

应将别名屏障分组并提交在一起，以最大限度地提高效率。

激活后，必须进一步初始化具有呈现目标或深度模具标志的资源。请参阅下面有关所需资源初始化的说明。

有关所需资源初始化的说明

某些资源类型仍然需要初始化。具有呈现目标或深度模具标志的资源必须使用清除操作或完整子资源副本集合进行初始化。如果使用别名屏障来表示两个别名资源之间的转换，则必须在别名屏障之后进行初始化。每当在简单模型中激活资源时，仍然需要此初始化。

在支持其他操作之前，必须使用以下操作之一初始化具有呈现目标或深度模具标志的放置资源和保留资源。

清除操作;例如 ClearRenderTargetView 或 ClearDepthStencilView。
DiscardResource 操作。
复制操作;例如 CopyBufferRegion、CopyTextureRegion 或 CopyResource。

应用程序应首选最明确的操作，该操作会导致修改的纹素量最少。请考虑以下示例。

使用深度缓冲区求解像素可见性通常需要每个深度纹素从 1.0 或 0 开始。因此，清除操作应该是别名深度缓冲区初始化的最有效选项。
应用程序可以使用别名呈现目标作为音调映射的目标。由于应用程序将在色调映射期间在每个像素上呈现，因此 DiscardResource 应该是进行初始化的最有效选项。

高级模型

在此模型中，可以忽略活动/非活动状态抽象。相反，必须遵循这些较低级别的规则。

别名屏障必须位于同一物理内存的两个不同 GPU 资源访问之间，只要这些访问位于同一 ExecuteCommandLists 调用中。
对某些类型别名资源的第一个呈现操作必须仍然是初始化，就像简单模型一样。

初始化操作必须针对整个子资源或 64KB 粒度进行。所有资源类型都支持整个子资源初始化。 64KB_UNDEFINED_SWIZZLE或64KB_STANDARD_SWIZZLE纹理布局的缓冲区和纹理支持 64KB 初始化粒度（以 64KB 偏移量对齐）， (引用 D3D12_TEXTURE_LAYOUT) 。

有关别名屏障的说明

别名屏障可以为 pResourceAfter 和 pResourceBefore 设置 NULL。 ExecuteCommandLists 的内存一致性定义和别名屏障是相同的，因此，当访问位于两个不同的 ExecuteCommandLists 调用中时，对同一物理内存的两个别名访问不需要别名屏障。

对于 D3D12 高级使用模型， ExecuteCommandLists 的 同步定义等效于别名屏障。因此，应用程序可以在重用物理内存之间插入别名屏障，或者确保在 对 ExecuteCommandLists 的两次单独调用中出现物理内存的两个别名用法。

停用量因资源属性而异。具有未定义内存布局的纹理是最坏的情况，因为整个纹理必须以原子方式停用。对于具有已定义布局的两个重叠资源，停用只能导致资源的重叠对齐区域。甚至可以很好地定义数据继承。有关详细信息，请参阅内存别名和数据继承。