Pular para o conteúdo principal
Serializa uma assinatura raiz de qualquer versão que pode ser passada para ID3D12Device::CreateRootSignature.

​
Sintaxe

​
Parâmetros

pRootSignature [in]
Tipo: const D3D12_VERSIONED_ROOT_SIGNATURE_DESC * Especifica uma D3D12_VERSIONED_ROOT_SIGNATURE_DESC que contém uma descrição de qualquer versão de uma assinatura raiz. ppBlob [out]
Tipo: ID3DBlob ** Um ponteiro para um bloco de memória que recebe um ponteiro para a interface ID3DBlob que você pode usar para acessar a assinatura raiz serializada. ppErrorBlob [out, optional]
Tipo: ID3DBlob ** Um ponteiro para um bloco de memória que recebe um ponteiro para a interface ID3DBlob que você pode usar para acessar mensagens de erro do serializador, ou NULL se não houver erros.

​
Valor retornado

Tipo: HRESULT Retorna S_OK se tiver êxito; caso contrário, retorna um dos Códigos de retorno do Direct3D 12.

​
Comentários

Se um aplicativo gerar proceduralmente uma estrutura de dados D3D12_ROOT_SIGNATURE_DESC1, ele deverá passar um ponteiro para essa D3D12_ROOT_SIGNATURE_DESC1 em uma chamada para D3D12SerializeVersionedRootSignature para criar a forma serializada. Em seguida, o aplicativo passa a forma serializada para a qual ppBlob aponta para ID3D12Device::CreateRootSignature. Se um sombreador tiver sido criado com uma assinatura raiz, o sombreador compilado já conterá uma assinatura raiz serializada. Nesse caso, passe o blob do sombreador compilado para ID3D12Device::CreateRootSignature para obter o objeto de assinatura raiz de tempo de execução.
Observe que, para desenvolvedores XBOX, o uso de assinaturas raiz criadas em HLSL é altamente recomendado.
A assinatura de função PFN_D3D12_SERIALIZE_VERSIONED_ROOT_SIGNATURE é fornecida como um typedef, para que você possa usar técnicas de vinculação dinâmica (GetProcAddress) em vez de vinculação estática. Esta função foi lançada com a Atualização de Aniversário do Windows 10 (14393) e substitui D3D12SerializeRootSignature.

​
Requisitos

Cabeçalho: d3d12_xs.h ou d3d12_x.h
Biblioteca: d3d12_xs.lib ou d3d12_x.lib
Plataformas com suporte: consoles XBOX Series e família XBOX One

​
Confira também

Funções principais Criando uma assinatura raiz D3DX12SerializeVersionedRootSignature Versão 1.1 da assinatura raiz
Última modificação em 6 de outubro de 2026

Tópicos relacionados

D3D12_VERSIONED_ROOT_SIGNATURE_DESCD3D12SerializeRootSignatureD3D12CreateVersionedRootSignatureDeserializerID3D12VersionedRootSignatureDeserializerID3D12RootSignatureDeserializer