ID3D12Device10::CreateReservedResource2 メソッド (d3d12.h)

ヒープ内のページにまだマップされていない予約済みのリソースを作成します。

DirectX 12 Agility SDK 1.7 以降が必要です。

構文

HRESULT CreateReservedResource2(
       const D3D12_RESOURCE_DESC      *pDesc,
       D3D12_BARRIER_LAYOUT           InitialLayout,
       const D3D12_CLEAR_VALUE        *pOptimizedClearValue,
       ID3D12ProtectedResourceSession *pProtectedSession,
       UINT32                         NumCastableFormats,
       const DXGI_FORMAT              *pCastableFormats,
  [in] REFIID                         riid,
       void                           **ppvResource
);

パラメーター

pDesc

型: const D3D12_RESOURCE_DESC*

リソースを記述する D3D12_RESOURCE_DESC 構造体へのポインター。

InitialLayout

テクスチャ リソースの初期レイアウト。バッファーの D3D12_BARRIER_LAYOUT::D 3D12_BARRIER_LAYOUT_UNDEFINED。

pOptimizedClearValue

型: 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 を に設定する必要があります。

pProtectedSession

型: ID3D12ProtectedResourceSession*

コンテンツ保護のセッションを表すオブジェクトへの省略可能なポインター。 指定した場合、このセッションはリソースを保護する必要があることを示します。 ID3D12ProtectedResourceSession を取得するには、ID3D12Device4::CreateProtectedResourceSessionを呼び出します。

NumCastableFormats

pCastableFormats内の要素の数。

pCastableFormats

このリソースをキャストできる DXGI_FORMAT 構造体の連続した配列。

[in] riid

型: REFIID

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

riidResource は、最も一般的に ID3D12Resourceの GUID ですが、任意のインターフェイスの GUID である可能性があります。 リソース オブジェクトがこの GUIDのインターフェイスをサポートしていない場合は、E_NOINTERFACEで作成が失敗します。

ppvResource

型: void**

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

ppvResource を nullptrして、機能テストを有効にすることができます。 ppvResource すると、オブジェクトは作成されません。pDesc が有効な場合 S_FALSE が返されます。

戻り値

型: HRESULT

関数が成功した場合は、S_OKを返します。 それ以外の場合は、HRESULTエラー コードを返します。

その他 可能な戻り値については、Direct3D 12 のリターン コード を参照してください。

備考

ID3D12Device.CreateReservedResourceの 解説 を参照してください。

必要条件

関連項目

CreateCommittedResource の

CreatePlacedResource の

ID3D12Device10