PSOs, Shaders, and Signatures

In order to render using DirectX 12, the complete description of the render state needs to be captured in a ID3D12PipelineState interface object (PSO). Compiled shaders for all stages you use are bound to the PSO at creation time. In order to share data between the HLSL shader and the CPU, the ID3D12RootSignature interface object describes how the shader expects parameters to be bound and is also part of the PSO.

Creating root signatures

Root signature management is one of the more challenging aspects of using DirectX 12. In Direct3D 11, you can think of every shader using the same 'mega signature', but in DirectX 12 you rarely need anything like the 128+ slots per stage that DirectX 11 provides. In DirectX Tool Kit for DirectX 12 we have a dozen or so different root signatures used internally used in different aspects.

Here's a basic root signature we use for BasicEffect when texturing using the D3DX12 utility library and DirectXHelpers function CreateRootSignature which combines the underlying D3D12SerializeRootSignature and ID3D12Device::CreateRootSignature calls:

// Create root signature.
Microsoft::WRL::ComPtr<ID3D12RootSignature> rootSig;
{
    D3D12_ROOT_SIGNATURE_FLAGS rootSignatureFlags =
        D3D12_ROOT_SIGNATURE_FLAG_ALLOW_INPUT_ASSEMBLER_INPUT_LAYOUT |
        D3D12_ROOT_SIGNATURE_FLAG_DENY_DOMAIN_SHADER_ROOT_ACCESS |
        D3D12_ROOT_SIGNATURE_FLAG_DENY_GEOMETRY_SHADER_ROOT_ACCESS |
        D3D12_ROOT_SIGNATURE_FLAG_DENY_HULL_SHADER_ROOT_ACCESS;

    // Create root parameters and initialize first (constants)
    CD3DX12_ROOT_PARAMETER rootParameters[RootParameterIndex::RootParameterCount] = {};
    rootParameters[RootParameterIndex::ConstantBuffer].InitAsConstantBufferView(0, 0, D3D12_SHADER_VISIBILITY_ALL);

    // Root parameter descriptor
    CD3DX12_ROOT_SIGNATURE_DESC rsigDesc = {};

    // Include texture and srv
    CD3DX12_DESCRIPTOR_RANGE textureSRV(D3D12_DESCRIPTOR_RANGE_TYPE_SRV, 1, 0);
    CD3DX12_DESCRIPTOR_RANGE textureSampler(D3D12_DESCRIPTOR_RANGE_TYPE_SAMPLER, 1, 0);

    rootParameters[RootParameterIndex::TextureSRV].InitAsDescriptorTable(1, &textureSRV, D3D12_SHADER_VISIBILITY_PIXEL);
    rootParameters[RootParameterIndex::TextureSampler].InitAsDescriptorTable(1, &textureSampler, D3D12_SHADER_VISIBILITY_PIXEL);

    // use all parameters
    rsigDesc.Init(_countof(rootParameters), rootParameters, 0, nullptr, rootSignatureFlags);

    DX::ThrowIfFailed(CreateRootSignature(device, &rsigDesc, rootSig.GetAddressOf()));
}

Compile shaders

UNDER DEVELOPMENT

Create pipeline state objects

UNDER DEVELOPMENT

Binding

UNDER DEVELOPMENT

Using Effects

In DirectX Tool Kit for DirectX 12, the individual Effects objects include per-device root signature and a per-instance pipeline state object. These are bound when the Apply method is invoked.