ResourceBarrier

​

Sintaxis

void ResourceBarrier(
    UINT NumBarriers,
    const D3D12_RESOURCE_BARRIER  pBarriers
)

​

Parámetros

​

Valor devuelto

​

Comentarios

• D3D12_RESOURCE_TRANSITION_BARRIER: las barreras de transición indican que un conjunto de subrecursos realiza la transición entre distintos usos. El autor de la llamada debe especificar los usos anterior y posterior de los subrecursos. La marca D3D12_RESOURCE_BARRIER_ALL_SUBRESOURCES se usa para realizar la transición de todos los subrecursos de un recurso al mismo tiempo.
• D3D12_RESOURCE_ALIASING_BARRIER: las barreras de alias indican una transición entre los usos de dos recursos diferentes que tienen asignaciones en el mismo montón. La aplicación puede especificar tanto el recurso anterior como el posterior. Tenga en cuenta que uno o ambos recursos pueden ser NULL (lo que indica que cualquier recurso en mosaico podría provocar alias).
• D3D12_RESOURCE_UAV_BARRIER: las barreras de vista de acceso desordenado indican que todos los accesos de UAV (de lectura o escritura) a un recurso concreto deben completarse antes de que pueda comenzar cualquier acceso de UAV futuro (de lectura o escritura). El recurso especificado puede ser NULL. No es necesario insertar una barrera de UAV entre dos llamadas de dibujo o distribución que solo lean un UAV. Además, no es necesario insertar una barrera de UAV entre dos llamadas de dibujo o distribución que escriban en el mismo UAV si la aplicación sabe que es seguro ejecutar los accesos de UAV en cualquier orden. El recurso puede ser NULL (lo que indica que cualquier acceso de UAV podría requerir la barrera).

• D3D12_RESOURCE_STATE_VERTEX_AND_CONSTANT_BUFFER
• D3D12_RESOURCE_STATE_INDEX_BUFFER
• D3D12_RESOURCE_STATE_NON_PIXEL_SHADER_RESOURCE
• D3D12_RESOURCE_STATE_PIXEL_SHADER_RESOURCE
• D3D12_RESOURCE_STATE_INDIRECT_ARGUMENT
• D3D12_RESOURCE_STATE_COPY_SOURCE
• D3D12_RESOURCE_STATE_DEPTH_READ

• D3D12_RESOURCE_STATE_UNORDERED_ACCESS
• D3D12_RESOURCE_STATE_DEPTH_WRITE

• D3D12_RESOURCE_STATE_COPY_DEST
• D3D12_RESOURCE_STATE_RENDER_TARGET
• D3D12_RESOURCE_STATE_STREAM_OUT

• El puntero al recurso no es NULL.
• El índice de subrecurso es válido
• Los estados anterior y posterior son compatibles con las marcas D3D12_RESOURCE_BINDING_TIER y D3D12_RESOURCE_FLAGS del recurso.
• Los bits reservados de las máscaras de estado no están establecidos.
• Los estados anterior y posterior son diferentes.
• El conjunto de bits de los estados anterior y posterior es válido.
• Si el bit D3D12_RESOURCE_STATE_RESOLVE_SOURCE está establecido, el recuento de muestras del recurso debe ser mayor que 1.
• Si el bit D3D12_RESOURCE_STATE_RESOLVE_DEST está establecido, el recuento de muestras del recurso debe ser igual a 1.

• Si una transición de subrecurso en una lista de comandos es incoherente con las transiciones anteriores de la misma lista de comandos.
• Si se usa un recurso sin llamar primero a ResourceBarrier para poner el recurso en el estado correcto.
• Si un recurso se enlaza de forma ilegal para lectura y escritura al mismo tiempo.
• Si los estados anteriores pasados a ResourceBarrier no coinciden con los estados posteriores de las llamadas anteriores a ResourceBarrier, incluido el caso de los alias.

• Todos los casos en los que la capa de depuración de D3D12 emitiría advertencias para ID3D12GraphicsCommandList::ResourceBarrier.
• Si se usa un búfer de profundidad en un modo que no es de solo lectura mientras el recurso tiene establecido el bit de uso D3D12_RESOURCE_STATE_PIXEL_SHADER_RESOURCE.

​

Ejemplos

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;

void D3D12HelloTriangle::PopulateCommandList()
{
// Command list allocators can only be reset when the associated
// command lists have finished execution on the GPU; apps should use
// fences to determine GPU execution progress.
ThrowIfFailed(m_commandAllocator->Reset());

// However, when ExecuteCommandList() is called on a particular command
// list, that command list can then be reset at any time and must be before
// re-recording.
ThrowIfFailed(m_commandList->Reset(m_commandAllocator.Get(), m_pipelineState.Get()));

// Set necessary state.
m_commandList->SetGraphicsRootSignature(m_rootSignature.Get());
m_commandList->RSSetViewports(1, &m_viewport);
m_commandList->RSSetScissorRects(1, &m_scissorRect);

// Indicate that the back buffer will be used as a render target.
m_commandList->ResourceBarrier(1, &CD3DX12_RESOURCE_BARRIER::Transition(m_renderTargets[m_frameIndex].Get(), D3D12_RESOURCE_STATE_PRESENT, D3D12_RESOURCE_STATE_RENDER_TARGET));

CD3DX12_CPU_DESCRIPTOR_HANDLE rtvHandle(m_rtvHeap->GetCPUDescriptorHandleForHeapStart(), m_frameIndex, m_rtvDescriptorSize);
m_commandList->OMSetRenderTargets(1, &rtvHandle, FALSE, nullptr);

// Record commands.
const float clearColor[] = { 0.0f, 0.2f, 0.4f, 1.0f };
m_commandList->ClearRenderTargetView(rtvHandle, clearColor, 0, nullptr);
m_commandList->IASetPrimitiveTopology(D3D_PRIMITIVE_TOPOLOGY_TRIANGLELIST);
m_commandList->IASetVertexBuffers(0, 1, &m_vertexBufferView);
m_commandList->DrawInstanced(3, 1, 0, 0);

// Indicate that the back buffer will now be used to present.
m_commandList->ResourceBarrier(1, &CD3DX12_RESOURCE_BARRIER::Transition(m_renderTargets[m_frameIndex].Get(), D3D12_RESOURCE_STATE_RENDER_TARGET, D3D12_RESOURCE_STATE_PRESENT));

ThrowIfFailed(m_commandList->Close());
}

​

Requisitos

​

Consulte también