ID3D12Device4

リソースの初期状態。D3D12_RESOURCE_STATES 列挙定数のビット単位の OR による組み合わせです。

D3D12_HEAP_TYPE_UPLOAD ヒープと共にリソースを作成する場合、InitialResourceState には D3D12_RESOURCE_STATE_GENERIC_READ を設定する必要があります。

D3D12_HEAP_TYPE_READBACK ヒープと共にリソースを作成する場合、InitialResourceState には D3D12_RESOURCE_STATE_COPY_DEST を設定する必要があります。

クリアカラーの既定値を記述する D3D12_CLEAR_VALUE 構造体を指定します。

pOptimizedClearValue には、クリア操作が最も最適化される値を指定します。作成するリソースが D3D12_RESOURCE_FLAG_ALLOW_RENDER_TARGET または D3D12_RESOURCE_FLAG_ALLOW_DEPTH_STENCIL フラグを持つテクスチャの場合は、クリア操作で最も頻繁に使用される値を選択してください。他の値でクリア操作を呼び出すこともできますが、リソース作成時に渡した値と一致する場合ほど効率的ではありません。

D3D12_RESOURCE_DIMENSION_BUFFER を使用する場合は、pOptimizedClearValue に nullptr を設定する必要があります。

ppvResource に返すリソースインターフェイスのグローバル一意識別子 (GUID) への参照です。

riidResource には通常 ID3D12Resource の GUID を指定しますが、任意のインターフェイスの GUID を指定することもできます。リソースオブジェクトがこの GUID のインターフェイスをサポートしていない場合、作成は E_NOINTERFACE で失敗します。

作成されたリソースオブジェクトの要求されたインターフェイスポインターを受け取るメモリブロックへの省略可能なポインターです。

ppvResource には nullptr を指定でき、機能テストを行えます。ppvResource が nullptr の場合、オブジェクトは作成されず、pDesc が有効であれば S_FALSE が返されます。

コンテンツ保護のためのセッションを表すオブジェクトへの省略可能なポインターです。指定した場合、このセッションはヒープを保護することを示します。ID3D12ProtectedResourceSession は ID3D12Device4::CreateProtectedResourceSession を呼び出して取得できます。

保護セッションを伴うヒープは、D3D12_HEAP_FLAG_SHARED_CROSS_ADAPTER フラグを指定して作成することはできません。

ppvHeap に返すヒープインターフェイスのグローバル一意識別子 (GUID) への参照です。

riidResource には通常 ID3D12Heap の GUID を指定しますが、任意のインターフェイスの GUID を指定することもできます。リソースオブジェクトがこの GUID のインターフェイスをサポートしていない場合、作成は E_NOINTERFACE で失敗します。

作成されたヒープオブジェクトの要求されたインターフェイスポインターを受け取るメモリブロックへの省略可能なポインターです。

ppvHeap には nullptr を指定でき、機能テストを行えます。ppvHeap が nullptr の場合、オブジェクトは作成されず、pDesc が有効であれば S_FALSE が返されます。

クリアカラーの既定値を記述する D3D12_CLEAR_VALUE 構造体を指定します。

pOptimizedClearValue には、クリア操作が最も最適化される値を指定します。作成するリソースが D3D12_RESOURCE_FLAG_ALLOW_RENDER_TARGET または D3D12_RESOURCE_FLAG_ALLOW_DEPTH_STENCIL フラグを持つテクスチャの場合は、クリア操作で最も頻繁に使用される値を選択してください。他の値でクリア操作を呼び出すこともできますが、リソース作成時に渡した値と一致する場合ほど効率的ではありません。

D3D12_RESOURCE_DIMENSION_BUFFER を使用する場合は、pOptimizedClearValue に nullptr を設定する必要があります。

ppvResource に返すリソースインターフェイスのグローバル一意識別子 (GUID) への参照です。解説 を参照してください。

riidResource には通常 ID3D12Resource の GUID を指定しますが、任意のインターフェイスの GUID を指定することもできます。リソースオブジェクトがこの GUID のインターフェイスをサポートしていない場合、作成は E_NOINTERFACE で失敗します。

作成されたリソースオブジェクトの要求されたインターフェイスポインターを受け取るメモリブロックへの省略可能なポインターです。

ppvResource には nullptr を指定でき、機能テストを行えます。ppvResource が nullptr の場合、オブジェクトは作成されず、pDesc が有効であれば S_FALSE が返されます。