Interface ID3D12CommandAllocator (d3d12.h)

Article
2024-02-29

Représente les allocations de stockage pour les commandes d’unité de traitement graphique (GPU).

Héritage

L’interface ID3D12CommandAllocator hérite d’ID3D12Pageable. ID3D12CommandAllocator a également les types de membres suivants :

Méthodes

L’interface ID3D12CommandAllocator possède ces méthodes.


ID3D12CommandAllocator ::Reset Indique de réutiliser la mémoire associée à l’allocateur de commande.

Remarques

Utilisez ID3D12Device ::CreateCommandAllocator pour créer un objet d’allocator de commande.

L’objet d’allocation de commandes correspond aux allocations sous-jacentes dans lesquelles les commandes GPU sont stockées. L’objet d’allocation de commandes s’applique à la fois aux listes de commandes directes et aux bundles. Vous devez utiliser un objet d’allocation de commande dans une application DirectX 12.

Exemples

L’exemple D3D12nBodyGravity utilise ID3D12CommandAllocator comme suit :

Déclarations de fichier d’en-tête.

D3D12_VIEWPORT m_viewport;
D3D12_RECT m_scissorRect;
ComPtr<IDXGISwapChain3> m_swapChain;
ComPtr<ID3D12Device> m_device;
ComPtr<ID3D12Resource> m_renderTargets[FrameCount];
ComPtr<ID3D12CommandAllocator> m_commandAllocator;
ComPtr<ID3D12CommandQueue> m_commandQueue;
ComPtr<ID3D12RootSignature> m_rootSignature;
ComPtr<ID3D12DescriptorHeap> m_rtvHeap;
ComPtr<ID3D12PipelineState> m_pipelineState;
ComPtr<ID3D12GraphicsCommandList> m_commandList;
UINT m_rtvDescriptorSize;

Thread de calcul asynchrone.

DWORD D3D12nBodyGravity::AsyncComputeThreadProc(int threadIndex)
{
    ID3D12CommandQueue* pCommandQueue = m_computeCommandQueue[threadIndex].Get();
    ID3D12CommandAllocator* pCommandAllocator = m_computeAllocator[threadIndex].Get();
    ID3D12GraphicsCommandList* pCommandList = m_computeCommandList[threadIndex].Get();
    ID3D12Fence* pFence = m_threadFences[threadIndex].Get();

    while (0 == InterlockedGetValue(&m_terminating))
    {
        // Run the particle simulation.
        Simulate(threadIndex);

        // Close and execute the command list.
        ThrowIfFailed(pCommandList->Close());
        ID3D12CommandList* ppCommandLists[] = { pCommandList };

        pCommandQueue->ExecuteCommandLists(1, ppCommandLists);

        // Wait for the compute shader to complete the simulation.
        UINT64 threadFenceValue = InterlockedIncrement(&m_threadFenceValues[threadIndex]);
        ThrowIfFailed(pCommandQueue->Signal(pFence, threadFenceValue));
        ThrowIfFailed(pFence->SetEventOnCompletion(threadFenceValue, m_threadFenceEvents[threadIndex]));
        WaitForSingleObject(m_threadFenceEvents[threadIndex], INFINITE);

        // Wait for the render thread to be done with the SRV so that
        // the next frame in the simulation can run.
        UINT64 renderContextFenceValue = InterlockedGetValue(&m_renderContextFenceValues[threadIndex]);
        if (m_renderContextFence->GetCompletedValue() < renderContextFenceValue)
        {
            ThrowIfFailed(pCommandQueue->Wait(m_renderContextFence.Get(), renderContextFenceValue));
            InterlockedExchange(&m_renderContextFenceValues[threadIndex], 0);
        }

        // Swap the indices to the SRV and UAV.
        m_srvIndex[threadIndex] = 1 - m_srvIndex[threadIndex];

        // Prepare for the next frame.
        ThrowIfFailed(pCommandAllocator->Reset());
        ThrowIfFailed(pCommandList->Reset(pCommandAllocator, m_computeState.Get()));
    }

    return 0;
}

Reportez-vous à l’exemple de code dans la référence D3D12.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	d3d12.h

Voir aussi

Interfaces principales

ID3D12Pageable

Partager via