構文
パラメーター
pDesc [in]型: const D3D12_RESOURCE_DESC * リソースを記述する D3D12_RESOURCE_DESC 構造体へのポインター。 InitialState [in]
型: D3D12_RESOURCE_STATES リソースの初期状態。D3D12_RESOURCE_STATES 列挙型定数のビットごとの OR 演算による組み合わせ。 pOptimizedClearValue [in, optional]
型: const D3D12_CLEAR_VALUE * クリア カラーのデフォルト値を記述する D3D12_CLEAR_VALUE 構造体を指定します。 pOptimizedClearValue は、クリア操作が最も最適化される値を指定します。作成されるリソースが D3D12_RESOURCE_FLAG_ALLOW_RENDER_TARGET または D3D12_RESOURCE_FLAG_ALLOW_DEPTH_STENCIL フラグを持つテクスチャの場合、クリア操作が最も頻繁に呼び出される値を選択する必要があります。他の値でクリア操作を呼び出すこともできますが、その操作はリソース作成時に渡された値と一致する場合ほど効率的ではありません。 D3D12_RESOURCE_DIMENSION_BUFFER を使用する場合は、pOptimizedClearValue を
nullptr に設定する必要があります。
riid [in]型: const IID & ppvResource で返されるリソース インターフェイスのグローバル一意識別子 (GUID) への参照。解説 を参照してください。 riidResource は最も一般的には ID3D12Resource の GUID ですが、任意のインターフェイスの GUID である可能性があります。リソース オブジェクトがこの GUID のインターフェイスをサポートしていない場合、作成は E_NOINTERFACE で失敗します。 ppvResource [out, optional]
型: void ** 作成されたリソース オブジェクトへの要求されたインターフェイス ポインターを受け取るメモリ ブロックへの省略可能なポインター。 ppvResource を
nullptr にして機能テストを有効にできます。ppvResource が nullptr の場合、オブジェクトは作成されず、pDesc が有効な場合は S_FALSE が返されます。
戻り値
型: HRESULT 関数が成功した場合、S_OK を返します。それ以外の場合は、HRESULT エラー コード を返します。
その他の戻り値については、Direct3D 12 の戻りコード を参照してください。
解説
CreateReservedResource は Direct3D 11 の D3D11_RESOURCE_MISC_TILED と同等です。仮想メモリのみを持ち、バッキング ストアを持たないリソースを作成します。 CopyTileMappings および UpdateTileMappings を使用して、リソースを物理メモリ (つまりヒープ) にマップする必要があります。 これらのリソース タイプは、アダプターがタイル化リソース ティア 1 以上をサポートしている場合にのみ作成できます。タイル化リソース ティアは、ヒープにマップされていないリソースへのアクセスの動作を定義します。要件
ヘッダー: d3d12_xs.h または d3d12_x.hライブラリ: d3d12_xs.lib または d3d12_x.lib
サポートされているプラットフォーム: XBOX Series 本体および XBOX One ファミリ