创建根签名

根签名是包含嵌套结构的复杂数据结构。 这些结构可以使用以下数据结构定义(包括帮助初始化成员的方法)以编程方式定义。 或者,可以使用高级着色语言 (HLSL) 编写它们,这样编译器可以尽早验证布局是否与着色器兼容。

用于创建根签名的 API 采用下面所述布局描述的序列化(独立无指针)版本。 提供了一个方法用于从 C++ 数据结构生成此序列化版本,获取序列化根签名定义的另一种方式是从使用根签名编译的着色器中检索该定义。

若要对根签名描述符和数据利用驱动程序优化,请参阅根签名版本 1.1

描述符表绑定类型

枚举 D3D12_DESCRIPTOR_RANGE_TYPE 定义可作为描述符表布局定义的一部分引用的描述符的类型。

它是一个范围,例如,如果描述符表的一部分具有 100 个 SRV,则可以在一个条目而不是 100 中声明该范围。 因此,描述符表定义是范围的集合。

typedef enum D3D12_DESCRIPTOR_RANGE_TYPE
{
  D3D12_DESCRIPTOR_RANGE_TYPE_SRV,
  D3D12_DESCRIPTOR_RANGE_TYPE_UAV,
  D3D12_DESCRIPTOR_RANGE_TYPE_CBV,
  D3D12_DESCRIPTOR_RANGE_TYPE_SAMPLER
} D3D12_DESCRIPTOR_RANGE_TYPE;

描述符范围

D3D12_DESCRIPTOR_RANGE结构定义给定类型 (的一系列描述符,例如描述符表中的 SRV) 。

D3D12_DESCRIPTOR_RANGE_OFFSET_APPEND通常用于OffsetInDescriptorsFromTableStartD3D12_DESCRIPTOR_RANGE的参数。 这意味着会在描述符表中前一个范围的后面定义描述符范围。 如果应用程序需要别名描述符,或出于某种原因需要跳过槽,可将 OffsetInDescriptorsFromTableStart 设置为所需的任意偏移量。 定义不同类型的重叠范围是无效的操作。

由组合RangeTypeNumDescriptorsBaseShaderRegister的着色器寄存器集,并且RegisterSpace不能在根签名中具有常见D3D12_SHADER_VISIBILITY (的声明之间冲突或重叠,请参阅) 下面的着色器可见性部分。

描述符表布局

D3D12_ROOT_DESCRIPTOR_TABLE结构将描述符表的布局声明为描述符范围的集合,该集合从描述符堆的给定偏移量开始。 CBV/UAV/SRV 所在的同一个描述符表中不允许采样器。

将根签名槽类型设置为 D3D12_ROOT_PARAMETER_TYPE_DESCRIPTOR_TABLE 时,将使用此结构。

若要设置图形(CBV、SRV、UAV、采样器)描述符表,请使用 ID3D12GraphicsCommandList::SetGraphicsRootDescriptorTable

若要设置计算描述符表,请使用 ID3D12GraphicsCommandList::SetComputeRootDescriptorTable

根常量

D3D12_ROOT_CONSTANTS结构在根签名中以一个常量缓冲区的形式声明常量。

将根签名槽类型设置为 D3D12_ROOT_PARAMETER_TYPE_32BIT_CONSTANTS 时,将使用此结构。

根描述符

D3D12_ROOT_DESCRIPTOR结构声明在根签名中内联) 着色器中显示的描述符 (。

将根签名槽类型设置为 D3D12_ROOT_PARAMETER_TYPE_CBVD3D12_ROOT_PARAMETER_TYPE_SRVD3D12_ROOT_PARAMETER_TYPE_UAV 时,将使用此结构。

着色器可见性

D3D12_SHADER_VISIBILITY枚举集到D3D12_ROOT_PARAMETER着色器可见性参数的成员确定哪些着色器查看给定根签名槽的内容。 计算始终使用_ALL (,因为只有一个活动阶段) 。 图形可以选择,但如果它使用_ALL,所有着色器阶段都会看到任何绑定在根签名槽。

着色器可见性的一种用途是帮助创建的着色器使用重叠的命名空间要求对每个着色器阶段使用不同的绑定。 例如,顶点着色器可以声明:

Texture2D foo : register(t0);

像素着色器还可以声明:

Texture2D bar : register(t0);

如果应用程序将根签名绑定绑定到 t0 VISIBILITY_ALL,则两个着色器都会看到相同的纹理。 如果着色器定义实际上希望每个着色器看到不同的纹理,则可以使用VISIBILITY_VERTEX和_PIXEL定义 2 个根签名槽。 无论对根签名槽的可见性是什么,处理一个固定最大根签名大小的开销都是相同的(开销仅取决于 SlotType)。

在低端 D3D11 硬件上,在验证根布局中描述符表的大小时,也会考虑SHADER_VISIBILITY,因为某些 D3D11 硬件只能支持每个阶段的最大绑定量。 仅当在低层硬件上运行且根本不限制新式硬件时,才会施加这些限制。

如果根签名定义了多个描述符表,这些表在命名空间中相互重叠, (着色器) 的寄存器绑定,并且其中任何一个表都指定了_ALL, (创建将失败) 。

根签名定义

D3D12_ROOT_SIGNATURE_DESC结构可以包含描述符表和内联常量、由D3D12_ROOT_PARAMETER结构和枚举D3D12_ROOT_PARAMETER_TYPE定义的每个槽类型。

若要启动根签名槽,请参阅 ID3D12GraphicsCommandListSetComputeRoot***SetGraphicsRoot 方法

静态采样器使用 D3D12_STATIC_SAMPLER 结构在根签名中描述。

许多标志将某些着色器的访问限制为根签名,请参阅 D3D12_ROOT_SIGNATURE_FLAGS

根签名数据结构序列化/反序列化

本部分所述的方法由 D3D12Core.dll 导出,提供用于序列化和反序列化根签名数据结构的方法。

序列化格式是创建根签名时传入 API 的格式。 如果编写的着色器包含根签名(添加该功能时),则编译的着色器已包含序列化的根签名。

如果应用程序在过程上生成 D3D12_ROOT_SIGNATURE_DESC 数据结构,则必须使用 D3D12SerializeRootSignature 生成序列化表单。 它的输出可传递到 ID3D12Device::CreateRootSignature

如果应用程序已包含序列化根签名或具有包含根签名的已编译着色器,并希望以编程方式发现布局定义(称为“反射”),则可以调用 D3D12CreateRootSignatureDeserializer。 这会生成 ID3D12RootSignatureDeserializer 接口,该接口包含返回反序列化 D3D12_ROOT_SIGNATURE_DESC 数据结构的方法。 该接口拥有反序列化数据结构的生存期。

根签名创建 API

ID3D12Device::CreateRootSignature API 采用根签名的序列化版本。

管道状态对象中的根签名

创建管道状态的方法 (ID3D12Device::CreateGraphicsPipelineStateID3D12Device::CreateComputePipelineState ) 采用可选的 ID3D12RootSignature 接口作为存储在 D3D12_GRAPHICS_PIPELINE_STATE_DESC 结构) 中的输入 (参数。 这会重写着色器中已存在的任何根签名。

如果将根签名传入某个创建管道状态方法,将会根据 PSO 中的所有着色器验证此根签名以确认是否兼容,并提供给驱动程序以用于所有着色器。 如果任何着色器包含不同的根签名,该签名将被 API 中传入的根签名替换。 如果未传入根签名,所有传入的着色器必须包含一个根签名,并且它们必须匹配 – 此签名将提供给驱动程序。 在命令列表或捆绑中设置 PSO 不会更改根签名。 可以通过 SetGraphicsRootSignatureSetComputeRootSignature 方法实现此目的。 调用 draw(graphics)/dispatch(compute) 时,应用程序必须确保当前 PSO 与当前根签名匹配,否则行为是不确定的。

用于定义版本 1.1 根签名的代码

以下示例演示如何创建采用以下格式的根签名:

RootParameterIndex 目录
[0] 根常量:{ b2 } (1 个 CBV)
[1] 描述符表:{ t2-t7, u0-u3 } (6 个 SRV + 4 个 UAV)
[2] 根 CBV:{ b0 } (1 个 CBV,静态数据)
[3] 描述符表:{ s0-s1 } (2 个采样器)
[4] 描述符表:{ t8 - unbounded } (无绑定的 SRV、易失性描述符)
[5] 描述符表:{ (t0, space1) - unbounded } (无绑定的 SRV、易失性描述符)
[6] 描述符表:{ b1 } (1 个 CBV,静态数据)

 

如果在大部分时间内都会使用根签名的大多数组成部分,则可能比过于频繁地切换根签名要好。 应用程序应该按更改频率从高到低的顺序将根签名中的条目排序。 当应用更改根签名任何组成部分的绑定时,驱动程序可能需要创建部分或全部根签名状态的副本,如果状态更改次数成倍增加,这可能会造成不菲的开销。

此外,根签名会定义一个在着色器寄存器 s3 中执行各向异性纹理过滤的静态采样器。

绑定此根签名后,可向 [0..6] 参数空间分配描述符表、根 CBV 和常量。 例如,描述符堆中的描述符表 (范围) 可以绑定到每个根参数 [1] 和 [3..6]。

CD3DX12_DESCRIPTOR_RANGE1 DescRange[6];

DescRange[0].Init(D3D12_DESCRIPTOR_RANGE_SRV,6,2); // t2-t7
DescRange[1].Init(D3D12_DESCRIPTOR_RANGE_UAV,4,0); // u0-u3
DescRange[2].Init(D3D12_DESCRIPTOR_RANGE_SAMPLER,2,0); // s0-s1
DescRange[3].Init(D3D12_DESCRIPTOR_RANGE_SRV,-1,8, 0,
                  D3D12_DESCRIPTOR_RANGE_FLAG_DESCRIPTORS_VOLATILE); // t8-unbounded
DescRange[4].Init(D3D12_DESCRIPTOR_RANGE_SRV,-1,0,1,
                  D3D12_DESCRIPTOR_RANGE_FLAG_DESCRIPTORS_VOLATILE); 
                                                            // (t0,space1)-unbounded
DescRange[5].Init(D3D12_DESCRIPTOR_RANGE_CBV,1,1,
                  D3D12_DESCRIPTOR_RANGE_FLAG_DATA_STATIC); // b1

CD3DX12_ROOT_PARAMETER1 RP[7];

RP[0].InitAsConstants(3,2); // 3 constants at b2
RP[1].InitAsDescriptorTable(2,&DescRange[0]); // 2 ranges t2-t7 and u0-u3
RP[2].InitAsConstantBufferView(0, 0, 
                               D3D12_ROOT_DESCRIPTOR_FLAG_DATA_STATIC); // b0
RP[3].InitAsDescriptorTable(1,&DescRange[2]); // s0-s1
RP[4].InitAsDescriptorTable(1,&DescRange[3]); // t8-unbounded
RP[5].InitAsDescriptorTable(1,&DescRange[4]); // (t0,space1)-unbounded
RP[6].InitAsDescriptorTable(1,&DescRange[5]); // b1

CD3DX12_STATIC_SAMPLER StaticSamplers[1];
StaticSamplers[0].Init(3, D3D12_FILTER_ANISOTROPIC); // s3
CD3DX12_VERSIONED_ROOT_SIGNATURE_DESC RootSig(7,RP,1,StaticSamplers);
ID3DBlob* pSerializedRootSig;
CheckHR(D3D12SerializeVersionedRootSignature(&RootSig,pSerializedRootSig)); 

ID3D12RootSignature* pRootSignature;
hr = CheckHR(pDevice->CreateRootSignature(
    pSerializedRootSig->GetBufferPointer(),pSerializedRootSig->GetBufferSize(),
    __uuidof(ID3D12RootSignature),
    &pRootSignature));

以下代码演示如何在图形命令列表中使用上述根签名。

InitializeMyDescriptorHeapContentsAheadOfTime(); // for simplicity of the 
                                                 // example
CreatePipelineStatesAhreadOfTime(pRootSignature); // The root signature is passed into 
                                     // shader / pipeline state creation
...

ID3D12DescriptorHeap* pHeaps[2] = {pCommonHeap, pSamplerHeap};
pGraphicsCommandList->SetDescriptorHeaps(2,pHeaps);
pGraphicsCommandList->SetGraphicsRootSignature(pRootSignature);
pGraphicsCommandList->SetGraphicsRootDescriptorTable(
                        6,heapOffsetForMoreData,DescRange[5].NumDescriptors);
pGraphicsCommandList->SetGraphicsRootDescriptorTable(5,heapOffsetForMisc,5000); 
pGraphicsCommandList->SetGraphicsRootDescriptorTable(4,heapOffsetForTerrain,20000);
pGraphicsCommandList->SetGraphicsRootDescriptorTable(
                        3,heapOffsetForSamplers,DescRange[2].NumDescriptors);
pGraphicsCommandList->SetComputeRootConstantBufferView(2,pDynamicCBHeap,&CBVDesc);

MY_PER_DRAW_STUFF stuff;
InitMyPerDrawStuff(&stuff);
pGraphicsCommandList->SetSetGraphicsRoot32BitConstants(
                        0,&stuff,0,RTSlot[0].Constants.Num32BitValues);

SetMyRTVAndOtherMiscBindings();

for(UINT i = 0; i < numObjects; i++)
{
    pGraphicsCommandList->SetPipelineState(PSO[i]);
    pGraphicsCommandList->SetGraphicsRootDescriptorTable(
                    1,heapOffsetForFooAndBar[i],DescRange[1].NumDescriptors);
    pGraphicsCommandList->SetGraphicsRoot32BitConstant(0,&i,1,drawIDOffset);
    SetMyIndexBuffers(i);
    pGraphicsCommandList->DrawIndexedInstanced(...);
}

根签名

在 HLSL 中指定根签名

使用根签名