Skip to main content
ルート署名の記述構造体を、要求されたバージョンに変換します。

構文

パラメーター

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_FLAGSD3D12_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年8月24日