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 を に設定するnullptr
必要があります。
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 が の場合、nullptr
オブジェクトは作成されません。pDesc が有効な場合、S_FALSEが返されます。
戻り値
種類: HRESULT
関数が成功した場合は、S_OK を返します。 それ以外の場合は、 HRESULTエラー コードが返されます。
戻り値 | 説明 |
---|---|
E_OUTOFMEMORY | リソースを作成するためのメモリが不足しています。 |
その他Direct3D 12可能な戻り値については、戻りコードを参照してください。
注釈
「ID3D12Device.CreateReservedResource の備考」を参照してください。
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | d3d12.h |
Library | D3d12.lib |
[DLL] | D3d12.dll |
こちらもご覧ください
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示