> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GetRootSignatureDescAtVersion

> Converte estruturas de descrição de assinatura raiz para uma versão solicitada.

Converte estruturas de descrição de assinatura raiz para uma versão solicitada.

## Sintaxe

```cpp theme={null}
HRESULT GetRootSignatureDescAtVersion(
    D3D_ROOT_SIGNATURE_VERSION convertToVersion,
    const D3D12_VERSIONED_ROOT_SIGNATURE_DESC  ppDesc
)
```

### Parâmetros

*convertToVersion*\
Tipo: **[D3D\_ROOT\_SIGNATURE\_VERSION](/pt-BR/reference/graphics/d3d12/enums/d3d_root_signature_version_public)**

Especifica a [D3D\_ROOT\_SIGNATURE\_VERSION](/pt-BR/reference/graphics/d3d12/enums/d3d_root_signature_version_public) necessária.

*ppDesc \[out]*\
Tipo: const D3D12\_VERSIONED\_ROOT\_SIGNATURE\_DESC \*\*

Contém a assinatura raiz desserializada em uma estrutura [D3D12\_VERSIONED\_ROOT\_SIGNATURE\_DESC](/pt-BR/reference/graphics/d3d12/structs/d3d12_versioned_root_signature_desc_public).

### Valor retornado

Tipo: HRESULT

Este método retorna um código de sucesso ou de erro HRESULT. O método pode falhar com E\_OUTOFMEMORY.

## Comentários

Este método aloca armazenamento adicional, se necessário, para a assinatura raiz convertida (memória pertencente à interface do desserializador). Se a conversão for feita, a interface do desserializador não libera a memória original da assinatura raiz desserializada; todas as versões para as quais a interface foi solicitada a converter ficam disponíveis até que o desserializador seja destruído.

Converter uma assinatura raiz de 1.1 para 1.0 descartará todos os [D3D12\_DESCRIPTOR\_RANGE\_FLAGS](/pt-BR/reference/graphics/d3d12/enums/d3d12_descriptor_range_flags_public) e [D3D12\_ROOT\_DESCRIPTOR\_FLAGS](/pt-BR/reference/graphics/d3d12/enums/d3d12_root_descriptor_flags_public); isso pode ser útil para gerar assinaturas raiz compatíveis que precisam ser executadas em sistemas operacionais antigos, embora perca oportunidades de otimização. Por exemplo, várias versões de assinatura raiz podem ser serializadas e armazenadas com os ativos do aplicativo, com a versão apropriada usada em runtime com base nas funcionalidades do sistema operacional.

Converter uma assinatura raiz de 1.0 para 1.1 apenas adiciona os sinalizadores apropriados para corresponder à semântica da 1.0.

## 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

[ID3D12VersionedRootSignatureDeserializer](/pt-BR/reference/graphics/d3d12/interfaces/id3d12versionedrootsignaturedeserializer/id3d12versionedrootsignaturedeserializer_public)

[Assinatura raiz versão 1.1](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/root-signature-version-1-1)


## Related topics

- [D3D_ROOT_SIGNATURE_VERSION](/pt-BR/reference/graphics/d3d12/enums/d3d_root_signature_version_public.md)
- [D3D12_VERSIONED_ROOT_SIGNATURE_DESC](/pt-BR/reference/graphics/d3d12/structs/d3d12_versioned_root_signature_desc_public.md)
- [D3D12CreateVersionedRootSignatureDeserializer](/pt-BR/reference/graphics/d3d12/functions/d3d12createversionedrootsignaturedeserializer_public.md)
- [GetRootSignatureDesc](/pt-BR/reference/graphics/d3d12/interfaces/id3d12rootsignaturedeserializer/methods/id3d12rootsignaturedeserializer_getrootsignaturedesc_public.md)
- [GetUnconvertedRootSignatureDesc](/pt-BR/reference/graphics/d3d12/interfaces/id3d12versionedrootsignaturedeserializer/methods/id3d12versionedrootsignaturedeserializer_getunconvertedrootsignaturedesc_public.md)