跳轉到主要內容
將根簽章描述結構轉換為要求的版本。

語法

參數

convertToVersion
類型:D3D_ROOT_SIGNATURE_VERSION
指定所需的 D3D_ROOT_SIGNATURE_VERSION。 ppDesc [out]
類型:const D3D12_VERSIONED_ROOT_SIGNATURE_DESC **
在 D3D12_VERSIONED_ROOT_SIGNATURE_DESC 結構中包含已還原序列化的根簽章。

傳回值

類型:HRESULT 此方法會傳回 HRESULT 成功碼或錯誤碼。此方法可能會因 E_OUTOFMEMORY 而失敗。

備註

如有需要,此方法會為轉換後的根簽章配置額外的儲存空間 (由還原序列化程式介面擁有的記憶體)。如果完成轉換,還原序列化程式介面不會釋放原始已還原序列化根簽章的記憶體,所有要求介面轉換的版本在還原序列化程式終結之前都可供使用。 將根簽章從 1.1 轉換為 1.0 會捨棄所有 D3D12_DESCRIPTOR_RANGE_FLAGS 和 D3D12_ROOT_DESCRIPTOR_FLAGS,這對於產生需要在舊版作業系統上執行的相容根簽章很有用,但會失去最佳化的機會。例如,可以將多個根簽章版本序列化並與應用程式資產一起儲存,並在執行階段根據作業系統功能使用適當的版本。 將根簽章從 1.0 轉換為 1.1 只會新增適當的旗標以符合 1.0 語意。

需求

標頭: d3d12_xs.h 或 d3d12_x.h
程式庫: d3d12_xs.lib 或 d3d12_x.lib
支援的平台: XBOX Series 主機與 XBOX One 系列

另請參閱

ID3D12VersionedRootSignatureDeserializer 根簽章 1.1 版
最後修改於 2026年10月6日