ID3D12Device

仮想アダプターを表します。コマンドアロケーター、コマンドリスト、コマンドキュー、フェンス、リソース、パイプラインステートオブジェクト、ヒープ、ルートシグネチャ、サンプラー、および多数のリソースビューを作成するために使用します。

デバイスを作成するには D3D12CreateDevice を使用します。

Windows 10 Anniversary Update では、ID3D12Device1 を通じて追加の機能を利用できます。

例

D3D1211on12 サンプルでは、ID3D12Device を次のように使用しています。

ヘッダーファイルでの宣言。

// Pipeline objects.
D3D12_VIEWPORT m_viewport;
ComPtr<IDXGISwapChain3> m_swapChain;
ComPtr<ID3D12Device> m_device;
ComPtr<ID3D12Resource> m_renderTargets[FrameCount];
ComPtr<ID3D12Resource> m_depthStencil;
ComPtr<ID3D12CommandAllocator> m_commandAllocator;
ComPtr<ID3D12GraphicsCommandList> m_commandList;
ComPtr<ID3D12CommandQueue> m_commandQueue;
ComPtr<ID3D12RootSignature >m_rootSignature;
ComPtr<ID3D12DescriptorHeap> m_rtvHeap;
ComPtr<ID3D12DescriptorHeap> m_cbvSrvHeap;
ComPtr<ID3D12DescriptorHeap> m_dsvHeap;
ComPtr<ID3D12DescriptorHeap> m_samplerHeap;
ComPtr<ID3D12PipelineState> m_pipelineState1;
ComPtr<ID3D12PipelineState> m_pipelineState2;
D3D12_RECT m_scissorRect;

サポートされている機能の確認。

inline UINT8 D3D12GetFormatPlaneCount(
    _In_ ID3D12Device* pDevice,
    DXGI_FORMAT Format
    )
{
    D3D12_FEATURE_DATA_FORMAT_INFO formatInfo = {Format};
    if (FAILED(pDevice->CheckFeatureSupport(D3D12_FEATURE_FORMAT_INFO, &formatInfo, sizeof(formatInfo))))
    {
        return 0;
    }
    return formatInfo.PlaneCount;
}

D3D12 リファレンスのサンプルコードを参照してください。

このデバイスに関連付けられている物理アダプター (ノード) の数を返します。

型: UINT

このデバイスが持つ物理アダプター (ノード) の数。

コマンドキューを作成します。

型: HRESULT

コマンドキューを作成するのに十分なメモリがない場合、このメソッドは E_OUTOFMEMORY を返します。その他の戻り値については Direct3D 12 のリターンコードを参照してください。

コマンドキューのインターフェイスの REFIID (GUID) は、__uuidof() マクロを使用して取得できます。たとえば、__uuidof(ID3D12CommandQueue) はコマンドキューのインターフェイスの GUID を取得します。

例

D3D12HelloTriangle サンプルでは、ID3D12Device::CreateCommandQueue を次のように使用しています。

D3D12_COMMAND_QUEUE_DESC queueDesc{};
queueDesc.Flags = D3D12_COMMAND_QUEUE_FLAG_NONE;
queueDesc.Type = D3D12_COMMAND_LIST_TYPE_DIRECT;

ThrowIfFailed(m_device->CreateCommandQueue(&queueDesc, IID_PPV_ARGS(&m_commandQueue)));

D3D12 リファレンスのサンプルコードを参照してください。

コマンドアロケーターオブジェクトを作成します。

型: HRESULT

コマンドアロケーターを作成するのに十分なメモリがない場合、このメソッドは E_OUTOFMEMORY を返します。 その他の戻り値については Direct3D 12 のリターンコードを参照してください。

デバイスはコマンドアロケーターからコマンドリストを作成します。

例

D3D12Bundles サンプルでは、ID3D12Device::CreateCommandAllocator を次のように使用しています。

ThrowIfFailed(pDevice->CreateCommandAllocator(D3D12_COMMAND_LIST_TYPE_DIRECT, IID_PPV_ARGS(&m_commandAllocator)));
ThrowIfFailed(pDevice->CreateCommandAllocator(D3D12_COMMAND_LIST_TYPE_BUNDLE, IID_PPV_ARGS(&m_bundleAllocator)));

D3D12 リファレンスのサンプルコードを参照してください。

グラフィックスパイプラインステートオブジェクトを作成します。

型: HRESULT

パイプラインステートオブジェクトを作成するのに十分なメモリがない場合、このメソッドは E_OUTOFMEMORY を返します。 その他の戻り値については Direct3D 12 のリターンコードを参照してください。

コンピュートパイプラインステートオブジェクトを作成します。

型: HRESULT

パイプラインステートオブジェクトを作成するのに十分なメモリがない場合、このメソッドは E_OUTOFMEMORY を返します。 その他の戻り値については Direct3D 12 のリターンコードを参照してください。

コマンドリストを作成します。

型: HRESULT

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

戻り値	説明
E_OUTOFMEMORY	コマンドリストを作成するのに十分なメモリがありません。

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

デバイスはコマンドアロケーターからコマンドリストを作成します。

例

D3D12Bundles サンプルでは、ID3D12Device::CreateCommandList を次のように使用しています。

パイプラインオブジェクトを作成します。

ComPtr<ID3D12CommandAllocator> m_commandAllocator;
ComPtr<ID3D12GraphicsCommandList> m_commandList;

コマンドアロケーターを作成します。

ThrowIfFailed(m_device->CreateCommandAllocator(D3D12_COMMAND_LIST_TYPE_DIRECT, IID_PPV_ARGS(&m_commandAllocator)));

ダイレクトコマンドリストを作成します。

ThrowIfFailed(m_device->CreateCommandList(0, D3D12_COMMAND_LIST_TYPE_DIRECT, m_commandAllocator.Get(), nullptr, IID_PPV_ARGS(&m_commandList)));

D3D12 リファレンスのサンプルコードを参照してください。

現在のグラフィックスドライバーがサポートする機能に関する情報を取得します。(ID3D12Device.CheckFeatureSupport)

型: HRESULT

成功した場合は S_OK を返します。pFeatureSupportData パラメーターにサポートされていないデータ型が渡された場合、または FeatureSupportDataSize パラメーターのサイズの不一致が検出された場合は E_INVALIDARG を返します。

使用例として、レイトレーシングのサポートを確認するには、pFeatureSupportData パラメーターに D3D12_FEATURE_DATA_D3D12_OPTIONS5 構造体を指定します。関数が正常に完了したら、値が設定された D3D12_FEATURE_DATA_D3D12_OPTIONS5 構造体の RaytracingTier フィールド (サポートされるレイトレーシング階層を示します) を参照します。

詳細については、機能の照会を参照してください。

DXGI フォーマットのハードウェアサポート

DXGI フォーマットとハードウェア機能の対応表については、次を参照してください。

• Direct3D 機能レベル 12.1 ハードウェアの DXGI フォーマットサポート
• Direct3D 機能レベル 12.0 ハードウェアの DXGI フォーマットサポート
• Direct3D 機能レベル 11.1 ハードウェアの DXGI フォーマットサポート
• Direct3D 機能レベル 11.0 ハードウェアの DXGI フォーマットサポート
• Direct3D 10Level9 フォーマットのハードウェアサポート
• Direct3D 機能レベル 10.1 ハードウェアのフォーマットサポート
• Direct3D 機能レベル 10.0 ハードウェアのフォーマットサポート

例

D3D1211on12 サンプルでは、ID3D12Device::CheckFeatureSupport を次のように使用しています。

inline UINT8 D3D12GetFormatPlaneCount(
    _In_ ID3D12Device* pDevice,
    DXGI_FORMAT Format
    )
{
    D3D12_FEATURE_DATA_FORMAT_INFO formatInfo = {Format};
    if (FAILED(pDevice->CheckFeatureSupport(D3D12_FEATURE_FORMAT_INFO, &formatInfo, sizeof(formatInfo))))
    {
        return 0;
    }
    return formatInfo.PlaneCount;
}

記述子ヒープオブジェクトを作成します。

型: HRESULT

記述子ヒープオブジェクトを作成するのに十分なメモリがない場合、このメソッドは E_OUTOFMEMORY を返します。 その他の戻り値については Direct3D 12 のリターンコードを参照してください。

記述子ヒープのインターフェイスの REFIID (GUID) は、__uuidof() マクロを使用して取得できます。たとえば、__uuidof(ID3D12DescriptorHeap) は記述子ヒープのインターフェイスの GUID を取得します。

例

D3D12HelloWorld サンプルでは、ID3D12Device::CreateDescriptorHeap を次のように使用しています。

レンダーターゲットビュー (RTV) 記述子ヒープを記述して作成します。

// Create descriptor heaps.
{
    // Describe and create a render target view (RTV) descriptor heap.
    D3D12_DESCRIPTOR_HEAP_DESC rtvHeapDesc = {};
    rtvHeapDesc.NumDescriptors = FrameCount;
    rtvHeapDesc.Type = D3D12_DESCRIPTOR_HEAP_TYPE_RTV;
    rtvHeapDesc.Flags = D3D12_DESCRIPTOR_HEAP_FLAG_NONE;
    ThrowIfFailed(m_device->CreateDescriptorHeap(&rtvHeapDesc, IID_PPV_ARGS(&m_rtvHeap)));

    m_rtvDescriptorSize = m_device->GetDescriptorHandleIncrementSize(D3D12_DESCRIPTOR_HEAP_TYPE_RTV);
}

// Create frame resources.
{
    CD3DX12_CPU_DESCRIPTOR_HANDLE rtvHandle(m_rtvHeap->GetCPUDescriptorHandleForHeapStart());

    // Create a RTV for each frame.
    for (UINT n = 0; n < FrameCount; n++)
    {
        ThrowIfFailed(m_swapChain->GetBuffer(n, IID_PPV_ARGS(&m_renderTargets[n])));
        m_device->CreateRenderTargetView(m_renderTargets[n].Get(), nullptr, rtvHandle);
        rtvHandle.Offset(1, m_rtvDescriptorSize);
    }

D3D12 リファレンスのサンプルコードを参照してください。

指定した種類の記述子ヒープにおけるハンドルのインクリメントサイズを取得します。この値は通常、記述子配列内のハンドルを正しい量だけ進めるために使用します。

指定した種類の記述子ヒープにおけるハンドルのインクリメントサイズ (必要なパディングを含む) を返します。

このメソッドが返す記述子サイズは、ヘルパー構造体 CD3DX12_CPU_DESCRIPTOR_HANDLE および CD3DX12_GPU_DESCRIPTOR_HANDLE への入力の 1 つとして使用されます。

例

D3D12PredicationQueries サンプルでは、ID3D12Device::GetDescriptorHandleIncrementSize を次のように使用しています。

リソース用の記述子ヒープを作成します。m_rtvDescriptorSize 変数はレンダーターゲットビューの記述子ハンドルのインクリメントサイズを保持し、コードのフレームリソースの作成のセクションで使用されます。

// Create descriptor heaps.
{
    // Describe and create a render target view (RTV) descriptor heap.
    D3D12_DESCRIPTOR_HEAP_DESC rtvHeapDesc = {};
    rtvHeapDesc.NumDescriptors = FrameCount;
    rtvHeapDesc.Type = D3D12_DESCRIPTOR_HEAP_TYPE_RTV;
    rtvHeapDesc.Flags = D3D12_DESCRIPTOR_HEAP_FLAG_NONE;
    ThrowIfFailed(m_device->CreateDescriptorHeap(&rtvHeapDesc, IID_PPV_ARGS(&m_rtvHeap)));

    // Describe and create a depth stencil view (DSV) descriptor heap.
    D3D12_DESCRIPTOR_HEAP_DESC dsvHeapDesc = {};
    dsvHeapDesc.NumDescriptors = 1;
    dsvHeapDesc.Type = D3D12_DESCRIPTOR_HEAP_TYPE_DSV;
    dsvHeapDesc.Flags = D3D12_DESCRIPTOR_HEAP_FLAG_NONE;
    ThrowIfFailed(m_device->CreateDescriptorHeap(&dsvHeapDesc, IID_PPV_ARGS(&m_dsvHeap)));

    // Describe and create a constant buffer view (CBV) descriptor heap.
    D3D12_DESCRIPTOR_HEAP_DESC cbvHeapDesc = {};
    cbvHeapDesc.NumDescriptors = CbvCountPerFrame * FrameCount;
    cbvHeapDesc.Type = D3D12_DESCRIPTOR_HEAP_TYPE_CBV_SRV_UAV;
    cbvHeapDesc.Flags = D3D12_DESCRIPTOR_HEAP_FLAG_SHADER_VISIBLE;
    ThrowIfFailed(m_device->CreateDescriptorHeap(&cbvHeapDesc, IID_PPV_ARGS(&m_cbvHeap)));

    // Describe and create a heap for occlusion queries.
    D3D12_QUERY_HEAP_DESC queryHeapDesc = {};
    queryHeapDesc.Count = 1;
    queryHeapDesc.Type = D3D12_QUERY_HEAP_TYPE_OCCLUSION;
    ThrowIfFailed(m_device->CreateQueryHeap(&queryHeapDesc, IID_PPV_ARGS(&m_queryHeap)));

    m_rtvDescriptorSize = m_device->GetDescriptorHandleIncrementSize(D3D12_DESCRIPTOR_HEAP_TYPE_RTV);
    m_cbvSrvDescriptorSize = m_device->GetDescriptorHandleIncrementSize(D3D12_DESCRIPTOR_HEAP_TYPE_CBV_SRV_UAV);
}

// Create frame resources.
{
    CD3DX12_CPU_DESCRIPTOR_HANDLE rtvHandle(m_rtvHeap->GetCPUDescriptorHandleForHeapStart());

    // Create a RTV and a command allocator for each frame.
    for (UINT n = 0; n < FrameCount; n++)
    {
        ThrowIfFailed(m_swapChain->GetBuffer(n, IID_PPV_ARGS(&m_renderTargets[n])));
        m_device->CreateRenderTargetView(m_renderTargets[n].Get(), nullptr, rtvHandle);
        rtvHandle.Offset(1, m_rtvDescriptorSize);

        ThrowIfFailed(m_device->CreateCommandAllocator(D3D12_COMMAND_LIST_TYPE_DIRECT, IID_PPV_ARGS(&m_commandAllocators[n])));
    }    
}

D3D12 リファレンスのサンプルコードを参照してください。

ルートシグネチャのレイアウトを作成します。

型: HRESULT

成功した場合は S_OK を返します。それ以外の場合は Direct3D 12 のリターンコードのいずれかを返します。

pBlobWithRootSignature が指す blob が無効な場合、このメソッドは E_INVALIDARG を返します。

アプリケーションが D3D12_ROOT_SIGNATURE_DESC データ構造体をプログラムで生成する場合は、その D3D12_ROOT_SIGNATURE_DESC へのポインターを D3D12SerializeRootSignature の呼び出しに渡してシリアル化形式を作成する必要があります。 その後、アプリケーションはシリアル化された形式を ID3D12Device::CreateRootSignature の呼び出しの pBlobWithRootSignature に渡します。

ルートシグネチャレイアウトのインターフェイスの REFIID (GUID) は、__uuidof() マクロを使用して取得できます。 たとえば、__uuidof(ID3D12RootSignature) はルートシグネチャのインターフェイスの GUID を取得します。

例

D3D12HelloTriangle サンプルでは、ID3D12Device::CreateRootSignature を次のように使用しています。

空のルートシグネチャを作成します。

CD3DX12_ROOT_SIGNATURE_DESC rootSignatureDesc;
rootSignatureDesc.Init(0, nullptr, 0, nullptr, D3D12_ROOT_SIGNATURE_FLAG_ALLOW_INPUT_ASSEMBLER_INPUT_LAYOUT);

ComPtr<ID3DBlob> signature;
ComPtr<ID3DBlob> error;
ThrowIfFailed(D3D12SerializeRootSignature(&rootSignatureDesc, D3D_ROOT_SIGNATURE_VERSION_1, &signature, &error));
ThrowIfFailed(m_device->CreateRootSignature(0, signature->GetBufferPointer(), signature->GetBufferSize(), IID_PPV_ARGS(&m_rootSignature)));

リソースデータにアクセスするための定数バッファービューを作成します。

リソース内のデータにアクセスするためのシェーダーリソースビューを作成します。(ID3D12Device.CreateShaderResourceView)

YUV 4:2:0 ビデオフォーマットの処理

アプリは輝度 (Y) プレーンと色差 (UV) プレーンを別々にマップする必要があります。これは、同じテクスチャに対して CreateShaderResourceView を 2 回呼び出し、1 チャネルのフォーマットと 2 チャネルのフォーマットを渡すことで行います。Y プレーンと互換性のある 1 チャネルのフォーマットを渡すと Y プレーンのみがマップされます。UV プレーン (両方まとめて) と互換性のある 2 チャネルのフォーマットを渡すと、U プレーンと V プレーンが単一のリソースビューとしてマップされます。

YUV 4:2:0 フォーマットの一覧は DXGI_FORMAT にあります。

例

D3D12nBodyGravity サンプルでは、ID3D12Device::CreateShaderResourceView を次のように使用しています。

1 つの記述に基づいて 2 つのシェーダーリソースビューを記述して作成します。

D3D12_SHADER_RESOURCE_VIEW_DESC srvDesc = {};
srvDesc.Shader4ComponentMapping = D3D12_DEFAULT_SHADER_4_COMPONENT_MAPPING;
srvDesc.Format = DXGI_FORMAT_UNKNOWN;
srvDesc.ViewDimension = D3D12_SRV_DIMENSION_BUFFER;
srvDesc.Buffer.FirstElement = 0;
srvDesc.Buffer.NumElements = ParticleCount;
srvDesc.Buffer.StructureByteStride = sizeof(Particle);
srvDesc.Buffer.Flags = D3D12_BUFFER_SRV_FLAG_NONE;

CD3DX12_CPU_DESCRIPTOR_HANDLE srvHandle0(m_srvUavHeap->GetCPUDescriptorHandleForHeapStart(), SrvParticlePosVelo0 + index, m_srvUavDescriptorSize);
CD3DX12_CPU_DESCRIPTOR_HANDLE srvHandle1(m_srvUavHeap->GetCPUDescriptorHandleForHeapStart(), SrvParticlePosVelo1 + index, m_srvUavDescriptorSize);
m_device->CreateShaderResourceView(m_particleBuffer0[index].Get(), &srvDesc, srvHandle0);
m_device->CreateShaderResourceView(m_particleBuffer1[index].Get(), &srvDesc, srvHandle1);

D3D12 リファレンスのサンプルコードを参照してください。

アンオーダードアクセス用のビューを作成します。

リソースデータにアクセスするためのレンダーターゲットビューを作成します。(ID3D12Device.CreateRenderTargetView)

リソースデータにアクセスするための深度ステンシルビューを作成します。

テクスチャのサンプリング情報をカプセル化するサンプラーオブジェクトを作成します。

記述子をコピー元からコピー先へコピーします。(ID3D12Device.CopyDescriptors)

可能な場合は、このメソッドよりも ID3D12Device::CopyDescriptorsSimple を使用してください。コピーが線形に行われるため、CPU キャッシュミス率が改善する可能性があります。

記述子をコピー元からコピー先へコピーします。(ID3D12Device.CopyDescriptorsSimple)

可能な場合は、ID3D12Device::CopyDescriptors よりもこのメソッドを使用してください。コピーが線形に行われるため、CPU キャッシュミス率が改善する可能性があります。

リソースと暗黙のヒープを同時に作成します。ヒープはリソース全体を格納できる大きさになり、リソースはそのヒープにマップされます。

型: HRESULT

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

戻り値	説明
E_OUTOFMEMORY	リソースを作成するのに十分なメモリがありません。

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

このメソッドはリソースとヒープを同時に作成します。ヒープはリソース全体を格納できる大きさになり、リソースはそのヒープにマップされます。作成されるヒープはアプリケーションからヒープオブジェクトを取得できないため、暗黙のヒープ (implicit heap) と呼ばれます。リソースへの最後の参照を解放する前に、アプリケーションは GPU がこのリソースの読み書きを行わなくなっていることを保証しなければなりません。

暗黙のヒープは、このメソッドがアプリケーションに制御を返す前に GPU からアクセス可能な常駐状態になります。常駐性も参照してください。

リソースの GPU 仮想アドレスのマッピングは変更できません。ID3D12CommandQueue::UpdateTileMappings およびボリュームタイルリソースを参照してください。

このメソッドは複数のスレッドから同時に呼び出すことができます。

例

D3D12Bundles サンプルでは、ID3D12Device::CreateCommittedResource を次のように使用しています。

頂点バッファーを作成します。

auto heapProperties = CD3DX12_HEAP_PROPERTIES(D3D12_HEAP_TYPE_DEFAULT);
auto resourceDesc = CD3DX12_RESOURCE_DESC::Buffer(SampleAssets::VertexDataSize);
ThrowIfFailed(m_device->CreateCommittedResource(
    &heapProperties,
    D3D12_HEAP_FLAG_NONE,
    &resourceDesc,
    D3D12_RESOURCE_STATE_COPY_DEST,
    nullptr,
    IID_PPV_ARGS(&m_vertexBuffer)));

Direct3D 12 リファレンスのサンプルコードを参照してください。

配置リソース (placed resource) および予約リソース (reserved resource) で使用できるヒープを作成します。

型: HRESULT

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

戻り値	説明
E_OUTOFMEMORY	ヒープを作成するのに十分なメモリがありません。

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

CreateHeap は、配置リソースおよび予約リソースで使用できるヒープを作成します。

ヒープへの最後の参照を解放する前に、アプリケーションは GPU がこのヒープの読み書きを行わなくなっていることを保証しなければなりません。

配置リソースのオブジェクトは、作成先のヒープへの参照を保持します。一方、予約リソースはヒープへの各マッピングについて参照を保持しません。

特定のヒープ内に配置されるリソースを作成します。配置リソースは最も軽量なリソースオブジェクトであり、作成と破棄が最も高速です。

型: HRESULT

リソースを作成するのに十分なメモリがない場合、このメソッドは E_OUTOFMEMORY を返します。その他の戻り値については Direct3D 12 のリターンコードを参照してください。

CreatePlacedResource は、予約リソースをヒープ内のオフセットに完全にマップすることに似ていますが、ヒープに関連付けられた仮想アドレス空間も再利用できる点が異なります。

配置リソースはコミットリソースよりも作成と破棄が軽量です。これは、それらの操作でヒープの作成や破棄が発生しないためです。さらに配置リソースは、リソースの作成と破棄よりもさらに軽量なメモリ再利用の手法、すなわちエイリアシングとエイリアシングバリアによる再利用を可能にします。複数の配置リソースが同じヒープ上で同時に重なり合うことができますが、同時に使用できるのは重なり合うリソースのうち 1 つだけです。

配置リソースの使用セマンティクスには、シンプルモデルとアドバンストモデルの 2 つがあります。アプリでアドバンストモデルが必要になることが判明するまでは、シンプルモデルを選ぶことをお勧めします (多様な GPU エコシステム全体でグラフィックスツールのサポートが最大限得られるためです)。

シンプルモデル

このモデルでは、配置リソースはアクティブまたは非アクティブのいずれかの状態にあると考えます。GPU が非アクティブなリソースを読み書きすることは不正です。配置リソースは非アクティブ状態で作成されます。

コマンドリスト上のエイリアシングバリアでリソースをアクティブ化するには、アプリケーションはそのリソースを D3D12_RESOURCE_ALIASING_BARRIER::pResourceAfter に渡します。アクティブ化の際、pResourceBefore は NULL のままで構いません。アクティブ化されたリソースと物理メモリを共有するすべてのリソース (重なり合う配置リソースおよび予約リソースを含む) は非アクティブになります。

効率を最大化するため、エイリアシングバリアはまとめてグループ化し、一括で送信してください。

アクティブ化後、レンダーターゲットまたは深度ステンシルのフラグを持つリソースはさらに初期化が必要です。以下のリソース初期化に関する注意を参照してください。

必要なリソース初期化に関する注意

一部のリソースの種類は初期化が必要です。レンダーターゲットまたは深度ステンシルのフラグを持つリソースは、クリア操作、またはサブリソース全体のコピーの集合によって初期化する必要があります。2 つのエイリアスされたリソース間の遷移を示すためにエイリアシングバリアを使用した場合、初期化はエイリアシングバリアの後で行う必要があります。この初期化は、シンプルモデルにおいてリソースがアクティブ化される場面では常に必要です。

レンダーターゲットまたは深度ステンシルのフラグを持つ配置リソースおよび予約リソースは、他の操作を行う前に次のいずれかの操作で初期化する必要があります。

• Clear 操作 (例: ClearRenderTargetView や ClearDepthStencilView)。
• DiscardResource 操作。
• Copy 操作 (例: CopyBufferRegion、CopyTextureRegion、CopyResource)。

アプリケーションは、変更されるテクセル数が最も少なくなる、最も明示的な操作を選ぶべきです。次の例を検討してください。

• ピクセルの可視性判定に深度バッファーを使用する場合、通常は各深度テクセルを 1.0 または 0 から開始する必要があります。したがって、エイリアスされた深度バッファーの初期化には Clear 操作が最も効率的なはずです。
• アプリケーションがエイリアスされたレンダーターゲットをトーンマッピングの出力先として使用する場合、トーンマッピング中にすべてのピクセルを描画するため、初期化には DiscardResource が最も効率的なはずです。

アドバンストモデル

このモデルでは、アクティブ/非アクティブという状態の抽象化を無視できます。その代わり、次のより低レベルの規則を守る必要があります。

• 同一の ExecuteCommandLists 呼び出し内で同じ物理メモリに対する 2 つの異なる GPU アクセスが行われる場合、その間にエイリアシングバリアが必要です。
• 特定の種類のエイリアスされたリソースへの最初のレンダリング操作は、シンプルモデルと同様に初期化でなければなりません。

初期化操作は、サブリソース全体に対して行うか、64KB 単位で行う必要があります。サブリソース全体の初期化はすべてのリソースの種類でサポートされます。64KB 境界に整列した 64KB 単位の初期化は、バッファーと、64KB_UNDEFINED_SWIZZLE または 64KB_STANDARD_SWIZZLE のテクスチャレイアウトを持つテクスチャでサポートされます (D3D12_TEXTURE_LAYOUT を参照)。

エイリアシングバリアに関する注意

エイリアシングバリアでは、pResourceAfter と pResourceBefore の両方を NULL に設定できます。ExecuteCommandLists のメモリ整合性の定義とエイリアシングバリアの定義は同じであり、同じ物理メモリへの 2 つのエイリアスされたアクセスが別々の ExecuteCommandLists 呼び出しで行われる場合、エイリアシングバリアは不要です。

D3D12 のアドバンストな使用モデルでは、ExecuteCommandLists の同期の定義はエイリアシングバリアと同等です。したがってアプリケーションは、物理メモリの再利用の間にエイリアシングバリアを挿入するか、物理メモリの 2 つのエイリアスされた使用が別々の ExecuteCommandLists 呼び出しで行われるようにするかのいずれかを選べます。

非アクティブ化される範囲はリソースのプロパティによって異なります。メモリレイアウトが未定義のテクスチャが最悪のケースで、テクスチャ全体をアトミックに非アクティブ化する必要があります。レイアウトが定義された 2 つの重なり合うリソースの場合、非アクティブ化はリソースの重なり合う整列済み領域のみに限定できます。データの継承も明確に定義できる場合があります。詳細については、メモリエイリアシングとデータ継承を参照してください。

予約リソース (reserved resource) を作成します。予約リソースは、まだヒープ内のいずれのページにもマップされていません。

型: HRESULT

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

戻り値	説明
E_OUTOFMEMORY	リソースを作成するのに十分なメモリがありません。

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

CreateReservedResource は、Direct3D 11 の D3D11_RESOURCE_MISC_TILED に相当します。仮想メモリのみを持ち、バッキングストアを持たないリソースを作成します。

このリソースを物理メモリ (すなわちヒープ) にマップするには、CopyTileMappings と UpdateTileMappings を使用する必要があります。

これらのリソースの種類は、アダプターがタイルリソース Tier 1 以上をサポートしている場合にのみ作成できます。タイルリソースの Tier は、ヒープにマップされていないリソースにアクセスした場合の動作を定義します。

ヒープ、リソース、またはフェンスオブジェクトへの共有ハンドルを作成します。

型: HRESULT

成功した場合は S_OK を返します。それ以外の場合は次のいずれかの値を返します。

• パラメーターのいずれかが無効な場合は DXGI_ERROR_INVALID_CALL。
• 共有するリソースに指定した名前が既に別のリソースに関連付けられている場合は DXGI_ERROR_NAME_ALREADY_EXISTS。
• 保護された名前空間にオブジェクトを作成しようとした場合は E_ACCESSDENIED。
• ハンドルを作成するのに十分なメモリがない場合は E_OUTOFMEMORY。
• その他、Direct3D 12 のリターンコードのトピックに記載されているエラーコード。

ヒープとコミットリソースの両方を共有できます。コミットリソースを共有すると、暗黙のヒープがコミットリソースの記述と共に共有され、別のデバイスから互換性のあるリソース記述をそのヒープにマップできるようになります。

Direct3D 11 と Direct3D 12 の相互運用シナリオでは、共有フェンスは DirectX 11 の ID3D11Device5::OpenSharedFence メソッドで開き、共有リソースは ID3D11Device::OpenSharedResource1 メソッドで開きます。

Direct3D 12 では、共有ハンドルは ID3D12Device::OpenSharedHandle または ID3D12Device::OpenSharedHandleByName メソッドで開きます。

HANDLE と REFIID を使用して、共有リソース、共有ヒープ、共有フェンスのハンドルを開きます。

型: HRESULT

このメソッドは Direct3D 12 のリターンコードのいずれかを返します。

Name と Access を使用して、共有リソース、共有ヒープ、共有フェンスのハンドルを開きます。

型: HRESULT

このメソッドは Direct3D 12 のリターンコードのいずれかを返します。

オブジェクトをデバイスに対して常駐 (resident) させます。

型: HRESULT

このメソッドは Direct3D 12 のリターンコードのいずれかを返します。

MakeResident は、リソースに関連付けられたデータをディスクから読み込み、そのリソースに適したメモリプールからメモリを再割り当てします。このメソッドは、物理メモリを所有するオブジェクトに対して呼び出す必要があります。

GPU のビデオメモリを管理するには、このメソッドと Evict を使用します。D3D11 ではこれが自動的に行われていましたが、D3D12 ではアプリが行う必要があります。

MakeResident と Evict は、多くのアダプターで常駐メモリ予算の管理に役立ちます。MakeResident は明示的にデータをページインし、その後ページアウトを抑止するため、GPU がデータにアクセスできるようになります。Evict はページアウトを許可します。

GPU アーキテクチャによっては、GPU 仮想アドレス空間が十分でないために常駐性の操作から利益を得られないものもあります。プロセスあたりの最大 GPU 仮想アドレス空間が小さすぎる、または常駐メモリ予算とほぼ同程度であるかを判断するには、D3D12_FEATURE_DATA_GPU_VIRTUAL_ADDRESS_SUPPORT と IDXGIAdapter3::QueryVideoMemoryInfo を使用します。そのようなアーキテクチャでは、常駐メモリ予算は常に GPU 仮想アドレス空間の量によって制約されます。そのようなシステムでは、Evict を呼んでも常駐メモリ予算は解放されません。

常駐メモリ予算に十分な空きがあるように見える場合でも、アプリケーションは MakeResident の失敗を処理しなければなりません。物理メモリの断片化やアダプターアーキテクチャ固有の制約により、大きな連続領域を利用できないことがあります。アプリケーションは常駐メモリ予算をさらに解放してから再試行してください。

MakeResident は参照カウント方式であり、Evict が効果を持つには MakeResident と同じ回数だけ Evict を呼び出す必要があります。常駐性をサポートするオブジェクトは作成時に常駐状態になるため、Evict を 1 回呼び出せば実際にオブジェクトは退避されます。

アプリケーションはフェンスを使用して、GPU が非常駐のオブジェクトを使用しないようにしなければなりません。GPU がオブジェクトを参照するコマンドリストを実行する前に MakeResident が戻っている必要があります。Evict は、オブジェクトを参照するコマンドリストの GPU での実行が完了した後に呼び出す必要があります。

退避されたオブジェクトも、同じ GPU 仮想アドレスと同じ量の GPU 仮想アドレス空間を引き続き消費します。したがって、Evict の後もリソース記述子やその他の GPU 仮想アドレス参照は無効になりません。

データのページアウトを有効にします。これにより、GPU からそのデータへのアクセスができなくなります。

型: HRESULT

このメソッドは Direct3D 12 のリターンコードのいずれかを返します。

Evict は、リソースに関連付けられたデータをディスクに永続化し、そのリソースが置かれていたメモリプールから取り除きます。このメソッドは、物理メモリを所有するオブジェクト、すなわちコミットリソース (仮想メモリと物理メモリの両方の割り当てを所有します) またはヒープに対して呼び出す必要があります。予約リソースは物理メモリを持たず、配置リソースはヒープからメモリを借りている点に注意してください。

MakeResident の解説も参照してください。

フェンスオブジェクトを作成します。(ID3D12Device.CreateFence)

型: HRESULT

成功した場合は S_OK を返します。それ以外の場合は Direct3D 12 のリターンコードのいずれかを返します。

デバイスが削除された理由を取得します。

型: HRESULT

このメソッドは、デバイスが削除された理由を返します。

コピー可能なリソースレイアウトを取得します。アップロードヒープ内の領域をサブアロケートする際に、D3D12_PLACED_SUBRESOURCE_FOOTPRINT と D3D12_SUBRESOURCE_FOOTPRINT を埋めるのに役立ちます。

このルーチンは、アップロードヒープ内の領域をサブアロケートする際に、アプリケーションが D3D12_PLACED_SUBRESOURCE_FOOTPRINT および D3D12_SUBRESOURCE_FOOTPRINT 構造体を埋めるのを支援します。 得られる構造体は GPU アダプターに依存しません。つまり、値は GPU アダプターによって変化しません。 GetCopyableFootprints は、(D3D12_RESOURCE_DESC 構造体から得られる) リソースフォーマット、テクスチャレイアウト、アラインメント要件の詳細を使用してサブリソース構造体を埋めます。 アプリケーションはこれらの詳細をすべて参照できるため、このメソッドやその派生をアプリの一部として実装することも可能です。

例

D3D12Multithreading サンプルでは、ID3D12Device::GetCopyableFootprints を次のように使用しています。

// Returns required size of a buffer to be used for data upload
inline UINT64 GetRequiredIntermediateSize(
    _In_ ID3D12Resource* pDestinationResource,
    _In_range_(0,D3D12_REQ_SUBRESOURCES) UINT FirstSubresource,
    _In_range_(0,D3D12_REQ_SUBRESOURCES-FirstSubresource) UINT NumSubresources)
{
    D3D12_RESOURCE_DESC Desc = pDestinationResource->GetDesc();
    UINT64 RequiredSize = 0;
    
    ID3D12Device* pDevice;
    pDestinationResource->GetDevice(__uuidof(*pDevice), reinterpret_cast<void**>(&pDevice));
    pDevice->GetCopyableFootprints(&Desc, FirstSubresource, NumSubresources, 0, nullptr, nullptr, nullptr, &RequiredSize);
    pDevice->Release();
    
    return RequiredSize;
}

D3D12 リファレンスのサンプルコードを参照してください。

クエリヒープを作成します。クエリヒープはクエリの配列を保持します。

型: HRESULT

このメソッドは Direct3D 12 のリターンコードのいずれかを返します。

詳細については クエリを参照してください。

例

D3D12PredicationQueries サンプルでは、ID3D12Device::CreateQueryHeap を次のように使用しています。

クエリヒープとクエリ結果バッファーを作成します。

// Pipeline objects.
D3D12_VIEWPORT m_viewport;
D3D12_RECT m_scissorRect;
ComPtr<IDXGISwapChain3> m_swapChain;
ComPtr<ID3D12Device> m_device;
ComPtr<ID3D12Resource> m_renderTargets[FrameCount];
ComPtr<ID3D12CommandAllocator> m_commandAllocators[FrameCount];
ComPtr<ID3D12CommandQueue> m_commandQueue;
ComPtr<ID3D12RootSignature> m_rootSignature;
ComPtr<ID3D12DescriptorHeap> m_rtvHeap;
ComPtr<ID3D12DescriptorHeap> m_cbvHeap;
ComPtr<ID3D12DescriptorHeap> m_dsvHeap;
ComPtr<ID3D12QueryHeap> m_queryHeap;
UINT m_rtvDescriptorSize;
UINT m_cbvSrvDescriptorSize;
UINT m_frameIndex;

// Synchronization objects.
ComPtr<ID3D12Fence> m_fence;
UINT64 m_fenceValues[FrameCount];
HANDLE m_fenceEvent;

// Asset objects.
ComPtr<ID3D12PipelineState> m_pipelineState;
ComPtr<ID3D12PipelineState> m_queryState;
ComPtr<ID3D12GraphicsCommandList> m_commandList;
ComPtr<ID3D12Resource> m_vertexBuffer;
ComPtr<ID3D12Resource> m_constantBuffer;
ComPtr<ID3D12Resource> m_depthStencil;
ComPtr<ID3D12Resource> m_queryResult;
D3D12_VERTEX_BUFFER_VIEW m_vertexBufferView;

// Describe and create a heap for occlusion queries.
D3D12_QUERY_HEAP_DESC queryHeapDesc = {};
queryHeapDesc.Count = 1;
queryHeapDesc.Type = D3D12_QUERY_HEAP_TYPE_OCCLUSION;
ThrowIfFailed(m_device->CreateQueryHeap(&queryHeapDesc, IID_PPV_ARGS(&m_queryHeap)));

D3D12 リファレンスのサンプルコードを参照してください。

特定の種類のプロファイリングや試験的なプロトタイピングを支援する、開発時向けの機能です。

型: HRESULT

このメソッドは Direct3D 12 のリターンコードのいずれかを返します。

このメソッドはアプリケーションの開発時にのみ有用です。動的周波数スケーリングによるアーティファクトの影響を受けずに、複数のアルゴリズムの GPU 使用状況をプロファイリングできるようになります。

出荷するアプリケーションの通常の実行時にこのメソッドを呼び出さないでください。このメソッドはマシンが開発者モードの場合にのみ機能します。開発者モードが有効でない場合はデバイスの削除が発生します。代わりに、既定でオフの開発者向けスイッチに応じてこのメソッドを呼び出してください。コマンドラインパラメーター、設定ファイル、レジストリキー、開発者向けコンソールコマンドに応じて呼び出すことは妥当な使用シナリオです。

安定電力状態では、通常アプリケーション負荷時にユーザーが経験する値よりも大幅に低い、遅めの設定に GPU のクロックレートが固定されます。このクロックレートの低下はシステム全体に影響します。プロセッサーが電力・電流・熱の限界を超えないようにするには、低いクロックレートが必要です。通常の使用シナリオでは、プロセッサーの動的なオーバークロック機能が活用されるのが一般的です。安定電力状態のもとで 2 つの設計を比較して得た結論は、実際の使用シナリオでの結果によって裏付けを取り、再確認する必要があります。

このメソッドはコマンドシグネチャを作成します。

型: HRESULT

このメソッドは Direct3D 12 のリターンコードのいずれかを返します。

タイルリソースがどのようにタイルに分割されるかについての情報を取得します。(ID3D12Device.GetResourceTiling)

ヒープサイズを計算して CreatePlacedResource を呼び出す際に必要となるテクスチャの総リソースサイズを見積もるには、GetResourceTiling ではなく GetResourceAllocationInfo を使用してください。 GetResourceTiling はこの目的には使用できません。

タイルリソースの詳細については、ボリュームタイルリソースを参照してください。

現在のデバイス (アダプター) のローカル一意識別子を取得します。

型: LUID

アダプターのローカル一意識別子。

このメソッドは、アダプターのハードウェアに固有の一意な識別子を返します。 アプリケーションはこの識別子を使用して、さまざまな API (Direct3D 12、DXGI) にまたがる堅牢なマッピングを定義できます。

ローカル一意識別子 (LUID) は 64 ビットの値であり、生成されたシステム上でのみ一意であることが保証されます。 ローカル一意識別子 (LUID) の一意性は、システムが再起動されるまでの間のみ保証されます。

#define global IID_ID3D12Device "{189819F1-1DB6-4B57-BE54-1821339B85F7}"
#usecom global ID3D12Device IID_ID3D12Device "{}"
#comfunc global ID3D12Device_GetNodeCount                      7
#comfunc global ID3D12Device_CreateCommandQueue                8 var,var,sptr
#comfunc global ID3D12Device_CreateCommandAllocator            9 int,var,sptr
#comfunc global ID3D12Device_CreateGraphicsPipelineState       10 var,var,sptr
#comfunc global ID3D12Device_CreateComputePipelineState        11 var,var,sptr
#comfunc global ID3D12Device_CreateCommandList                 12 int,int,sptr,sptr,var,sptr
#comfunc global ID3D12Device_CheckFeatureSupport               13 int,sptr,int
#comfunc global ID3D12Device_CreateDescriptorHeap              14 var,var,sptr
#comfunc global ID3D12Device_GetDescriptorHandleIncrementSize  15 int
#comfunc global ID3D12Device_CreateRootSignature               16 int,sptr,sptr,var,sptr
#comfunc global ID3D12Device_CreateConstantBufferView          17 var,int
#comfunc global ID3D12Device_CreateShaderResourceView          18 sptr,var,int
#comfunc global ID3D12Device_CreateUnorderedAccessView         19 sptr,sptr,var,int
#comfunc global ID3D12Device_CreateRenderTargetView            20 sptr,var,int
#comfunc global ID3D12Device_CreateDepthStencilView            21 sptr,var,int
#comfunc global ID3D12Device_CreateSampler                     22 var,int
#comfunc global ID3D12Device_CopyDescriptors                   23 int,var,var,int,var,var,int
#comfunc global ID3D12Device_CopyDescriptorsSimple             24 int,int,int,int
#comfunc global ID3D12Device_GetResourceAllocationInfo         25 int,int,var
#comfunc global ID3D12Device_GetCustomHeapProperties           26 int,int
#comfunc global ID3D12Device_CreateCommittedResource           27 var,int,var,int,var,var,sptr
#comfunc global ID3D12Device_CreateHeap                        28 var,var,sptr
#comfunc global ID3D12Device_CreatePlacedResource              29 sptr,int64,var,int,var,var,sptr
#comfunc global ID3D12Device_CreateReservedResource            30 var,int,var,var,sptr
#comfunc global ID3D12Device_CreateSharedHandle                31 sptr,var,int,wstr,sptr
#comfunc global ID3D12Device_OpenSharedHandle                  32 sptr,var,sptr
#comfunc global ID3D12Device_OpenSharedHandleByName            33 wstr,int,sptr
#comfunc global ID3D12Device_MakeResident                      34 int,sptr
#comfunc global ID3D12Device_Evict                             35 int,sptr
#comfunc global ID3D12Device_CreateFence                       36 int64,int,var,sptr
#comfunc global ID3D12Device_GetDeviceRemovedReason            37
#comfunc global ID3D12Device_GetCopyableFootprints             38 var,int,int,int64,var,var,var,var
#comfunc global ID3D12Device_CreateQueryHeap                   39 var,var,sptr
#comfunc global ID3D12Device_SetStablePowerState               40 int
#comfunc global ID3D12Device_CreateCommandSignature            41 var,sptr,var,sptr
#comfunc global ID3D12Device_GetResourceTiling                 42 sptr,var,var,var,var,int,var
#comfunc global ID3D12Device_GetAdapterLuid                    43
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。