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

> 將根簽章描述結構轉換為要求的版本。

將根簽章描述結構轉換為要求的版本。

## 語法

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

### 參數

*convertToVersion*\
類型：**[D3D\_ROOT\_SIGNATURE\_VERSION](/zh-TW/reference/graphics/d3d12/enums/d3d_root_signature_version_public)**

指定所需的 [D3D\_ROOT\_SIGNATURE\_VERSION](/zh-TW/reference/graphics/d3d12/enums/d3d_root_signature_version_public)。

*ppDesc \[out]*\
類型：const D3D12\_VERSIONED\_ROOT\_SIGNATURE\_DESC \*\*

在 [D3D12\_VERSIONED\_ROOT\_SIGNATURE\_DESC](/zh-TW/reference/graphics/d3d12/structs/d3d12_versioned_root_signature_desc_public) 結構中包含已還原序列化的根簽章。

### 傳回值

類型：HRESULT

此方法會傳回 HRESULT 成功碼或錯誤碼。此方法可能會因 E\_OUTOFMEMORY 而失敗。

## 備註

如有需要，此方法會為轉換後的根簽章配置額外的儲存空間 (由還原序列化程式介面擁有的記憶體)。如果完成轉換，還原序列化程式介面不會釋放原始已還原序列化根簽章的記憶體，所有要求介面轉換的版本在還原序列化程式終結之前都可供使用。

將根簽章從 1.1 轉換為 1.0 會捨棄所有 [D3D12\_DESCRIPTOR\_RANGE\_FLAGS](/zh-TW/reference/graphics/d3d12/enums/d3d12_descriptor_range_flags_public) 和 [D3D12\_ROOT\_DESCRIPTOR\_FLAGS](/zh-TW/reference/graphics/d3d12/enums/d3d12_root_descriptor_flags_public)，這對於產生需要在舊版作業系統上執行的相容根簽章很有用，但會失去最佳化的機會。例如，可以將多個根簽章版本序列化並與應用程式資產一起儲存，並在執行階段根據作業系統功能使用適當的版本。

將根簽章從 1.0 轉換為 1.1 只會新增適當的旗標以符合 1.0 語意。

## 需求

**標頭:** d3d12\_xs.h 或 d3d12\_x.h\
**程式庫:** d3d12\_xs.lib 或 d3d12\_x.lib\
**支援的平台**: XBOX Series 主機與 XBOX One 系列

## 另請參閱

[ID3D12VersionedRootSignatureDeserializer](/zh-TW/reference/graphics/d3d12/interfaces/id3d12versionedrootsignaturedeserializer/id3d12versionedrootsignaturedeserializer_public)

[根簽章 1.1 版](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/root-signature-version-1-1)


## Related topics

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