Método ID3D12GraphicsCommandList::ResourceBarrier (d3d12.h)

Artículo
08/23/2023

Notifica al controlador que necesita sincronizar varios accesos a los recursos.

Sintaxis

void ResourceBarrier(
  [in] UINT                         NumBarriers,
  [in] const D3D12_RESOURCE_BARRIER *pBarriers
);

Parámetros

[in] NumBarriers

Tipo: UINT

Número de descripciones de barrera enviadas.

[in] pBarriers

Tipo: const D3D12_RESOURCE_BARRIER*

Puntero a una matriz de descripciones de barreras.

Valor devuelto

Ninguno

Observaciones

Nota

Se debe crear un recurso para el estado de D3D12_RESOURCE_STATE_RAYTRACING_ACCELERATION_STRUCTURE en ese estado y, a continuación, nunca se ha pasado de él. Tampoco es posible que un recurso que se haya creado no en ese estado se realice la transición a él. Para obtener más información, consulte Restricciones de memoria de la estructura de aceleración en la especificación funcional de Raytracing (DXR) de DirectX en GitHub.

Hay tres tipos de descripciones de barreras:

D3D12_RESOURCE_TRANSITION_BARRIER : las barreras de transición indican que un conjunto de subrecursos realiza una transición entre distintos usos. El autor de la llamada debe especificar los usos antes y después 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 después. 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 UAV (lectura o escritura) a un recurso determinado deben completarse antes de que puedan comenzar los futuros accesos UAV (lectura o escritura). El recurso especificado puede ser NULL. No es necesario insertar una barrera UAV entre dos llamadas de dibujo o envío que solo leen un UAV. Además, no es necesario insertar una barrera UAV entre dos llamadas de dibujo o envío que escriben en el mismo UAV si la aplicación sabe que es seguro ejecutar los accesos UAV en cualquier orden. El recurso puede ser NULL (lo que indica que cualquier acceso UAV podría requerir la barrera).

Cuando ID3D12GraphicsCommandList::ResourceBarrier se pasa una matriz de descripciones de barreras de recursos, la API se comporta como si se llamara N veces (1 para cada elemento de matriz), en el orden especificado. Las transiciones se deben agrupar por lotes en una sola llamada API siempre que sea posible, como una optimización del rendimiento.

Para obtener descripciones de los estados de uso en los que puede encontrarse un subrecurso, consulte la enumeración D3D12_RESOURCE_STATES y la sección Using Resource Barriers to Synchronize Resource States in Direct3D 12 (Usar barreras de recursos para sincronizar estados de recursos en Direct3D 12 ).

Todos los subrecursos de un recurso deben estar en estado de RENDER_TARGET o DEPTH_WRITE estado, para los recursos de galería de símbolos de profundidad o destinos de representación, respectivamente, cuando se llama a ID3D12GraphicsCommandList::D iscardResource .

Cuando se presenta un búfer de reserva, debe estar en el estado D3D12_RESOURCE_STATE_PRESENT. Si se llama a IDXGISwapChain1::P resent1 en un recurso que no está en el estado PRESENT, se emitirá una advertencia de capa de depuración.

Los bits de uso de recursos se agrupan en dos categorías, de solo lectura y de lectura y escritura.

Los siguientes bits de uso son de solo lectura:

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

Los siguientes bits de uso son de lectura y escritura:

D3D12_RESOURCE_STATE_UNORDERED_ACCESS
D3D12_RESOURCE_STATE_DEPTH_WRITE

Los siguientes bits de uso son de solo escritura:

D3D12_RESOURCE_STATE_COPY_DEST
D3D12_RESOURCE_STATE_RENDER_TARGET
D3D12_RESOURCE_STATE_STREAM_OUT

Se puede establecer como máximo un bit de escritura. Si se establece algún bit de escritura, no se puede establecer ningún bit de lectura. Si no se establece ningún bit de escritura, se puede establecer cualquier número de bits de lectura.

En un momento dado, un subrecurso se encuentra exactamente en un estado (determinado por un conjunto de marcas). La aplicación debe asegurarse de que los estados coinciden al realizar una secuencia de llamadas a ResourceBarrier . En otras palabras, los estados antes y después de las llamadas consecutivas a ResourceBarrier deben aceptar.

Para realizar la transición de todos los subrecursos dentro de un recurso, la aplicación puede establecer el índice de subrecursos en D3D12_RESOURCE_BARRIER_ALL_SUBRESOURCES, lo que implica que se cambian todos los subrecursos.

Para mejorar el rendimiento, las aplicaciones deben usar barreras divididas (consulte Sincronización de varios motores). La aplicación también debe procesar por lotes varias transiciones en una sola llamada siempre que sea posible.

Validación en tiempo de ejecución

El tiempo de ejecución validará que los valores de tipo de barrera son miembros válidos de la enumeración D3D12_RESOURCE_BARRIER_TYPE .

Además, el tiempo de ejecución comprueba lo siguiente:

El puntero de recurso no es NULL.
El índice de subrecursos es válido
Los estados antes y después son compatibles con las marcas D3D12_RESOURCE_BINDING_TIER y D3D12_RESOURCE_FLAGS del recurso.
No se establecen bits reservados en las máscaras de estado.
Los estados antes y después son diferentes.
El conjunto de bits de los estados antes y después son válidos.
Si se establece el bit de D3D12_RESOURCE_STATE_RESOLVE_SOURCE, el recuento de muestras de recursos debe ser mayor que 1.
Si se establece el bit de D3D12_RESOURCE_STATE_RESOLVE_DEST, el recuento de muestras de recursos debe ser igual a 1.

En el caso de las barreras de alias, el tiempo de ejecución validará que, si alguno de los punteros de recursos no es NULL, hace referencia a un recurso en mosaico.

En el caso de las barreras UAV, el tiempo de ejecución validará que, si el recurso no es NULL, el recurso tiene establecida la marca de enlace D3D12_RESOURCE_STATE_UNORDERED_ACCESS.

El error de validación provoca que ID3D12GraphicsCommandList::Close devuelva E_INVALIDARG.

Capa de depuración

Normalmente, la capa de depuración emite errores en los que se produce un error en la validación en tiempo de ejecución:

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

Mientras que la capa de depuración intenta validar las reglas en tiempo de ejecución, funciona de forma conservadora para que los errores de la capa de depuración sean errores reales y, en algunos casos, los errores reales pueden no producir errores de capa de depuración.

La capa de depuración emitirá advertencias en los casos siguientes:

Todos los casos en los que la capa de depuración D3D12 emite 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

El ejemplo D3D12HelloTriangle usa ID3D12GraphicsCommandList::ResourceBarrier de la siguiente manera:

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());
}

Vea Código de ejemplo en la referencia de D3D12.

Requisitos


Plataforma de destino	Windows
Encabezado	d3d12.h
Library	D3d12.lib
Archivo DLL	D3d12.dll

Consulte también

ID3D12GraphicsCommandList

Uso de barreras de recursos para sincronizar los estados de los recursos en Direct3D 12

Compartir a través de