D3DX12SerializeVersionedRootSignature function

Article
12/30/2021

Helps enable root signature 1.1 features when they are available, and does not require maintaining two code paths for building root signatures. This helper method reconstructs a version 1.0 root signature when version 1.1 is not supported.

Syntax

HRESULT inline D3DX12SerializeVersionedRootSignature(
  _In_      const D3D12_VERSIONED_ROOT_SIGNATURE_DESC *pRootSignatureDesc,
                  D3D_ROOT_SIGNATURE_VERSION          MaxVersion,
  _Out_           ID3DBlob                            **ppBlob,
  _Out_opt_       ID3DBlob                            **ppErrorBlob
);

Parameters

pRootSignatureDesc [in]

Type: const D3D12_VERSIONED_ROOT_SIGNATURE_DESC*

Specifies a D3D12_VERSIONED_ROOT_SIGNATURE_DESC that contains a description of any version of a root signature.

MaxVersion

Type: D3D_ROOT_SIGNATURE_VERSION

Specifies the maximum supported D3D_ROOT_SIGNATURE_VERSION.

ppBlob [out]

Type: ID3DBlob**

A pointer to a memory block that receives a pointer to the ID3DBlob interface that you can use to access the serialized root signature.

ppErrorBlob [out, optional]

Type: ID3DBlob**

A pointer to a memory block that receives a pointer to the ID3DBlob interface that you can use to access serializer error messages, or NULL if there are no errors.

Return value

Type: HRESULT

Returns S_OK if successful; otherwise, returns one of the Direct3D 12 Return Codes.

Remarks

This function was released to coincide with the Windows 10 Anniversary Update (14393). In order to support Windows 10 versions prior to this, use of this function requires d3d12.lib be set up for delay loading.

Requirements

Requirement	Value
Header	D3dx12.h
Library	D3D12.lib
DLL	D3D12.dll