構文
パラメーター
pDesc [in]型: const D3D12_HEAP_DESC * ヒープを記述する定数 D3D12_HEAP_DESC 構造体へのポインター。 pProtectedSession [in, optional]
型: ID3D12ProtectedResourceSession * コンテンツ保護のセッションを表すオブジェクトへのオプションのポインター。指定された場合、このセッションはヒープが保護されるべきであることを示します。ID3D12ProtectedResourceSession は ID3D12Device4::CreateProtectedResourceSession を呼び出して取得できます。 保護されたセッションを持つヒープは、D3D12_HEAP_FLAG_SHARED_CROSS_ADAPTER フラグを使用して作成することはできません。 riid [in]
型: const IID & ppvHeap に返すヒープ インターフェイスのグローバル一意識別子 (GUID) への参照。 riidResource は最も一般的には ID3D12Heap の GUID ですが、任意のインターフェイスの GUID にすることができます。リソース オブジェクトがこの GUID のインターフェイスをサポートしていない場合、作成は E_NOINTERFACE で失敗します。 ppvHeap [out, optional]
型: void ** 作成されたヒープ オブジェクトへの要求されたインターフェイス ポインターを受け取るメモリ ブロックへのオプションのポインター。 ppvHeap は
nullptr にでき、機能テストを有効にします。ppvHeap が nullptr の場合、オブジェクトは作成されず、pDesc が有効な場合は S_FALSE が返されます。
戻り値
型: HRESULT 関数が成功した場合は S_OK を返します。それ以外の場合は HRESULT エラー コード を返します。
その他の可能な戻り値については、Direct3D 12 の戻り値コード を参照してください。
解説
CreateHeap1 は、配置リソースおよび予約済みリソースで使用できるヒープを作成します。 ヒープの最後の参照を解放する前に、アプリケーションは GPU がこのヒープの読み取りや書き込みを行わなくなることを確認する必要があります。 配置リソース オブジェクトは、作成元のヒープへの参照を保持しますが、予約済みリソースは、ヒープに対して行われた各マッピングの参照を保持しません。要件
ヘッダー: d3d12_xs.hライブラリ: d3d12_xs.lib
サポートされるプラットフォーム: XBOX Series 本体