Interfaz ID3D12GraphicsCommandList (d3d12.h)
Encapsula una lista de comandos gráficos para la representación. Incluye API para instrumentar la ejecución de la lista de comandos y para establecer y borrar el estado de la canalización.
Nota La versión más reciente de esta interfaz es ID3D12GraphicsCommandList1 introducida en el Windows 10 Creators Update. Las aplicaciones destinadas a Windows 10 Creators Update deben usar la interfaz ID3D12GraphicsCommandList1 en lugar de ID3D12GraphicsCommandList.
Herencia
La interfaz ID3D12GraphicsCommandList hereda de ID3D12CommandList. ID3D12GraphicsCommandList también tiene estos tipos de miembros:
Métodos
La interfaz ID3D12GraphicsCommandList tiene estos métodos.
| ID3D12GraphicsCommandList::BeginEvent No se debe llamar a este método directamente. Use el entorno de ejecución de eventos PIX para insertar eventos en una lista de comandos. (ID3D12GraphicsCommandList.BeginEvent) |
| ID3D12GraphicsCommandList::BeginQuery Inicia una consulta en ejecución. (ID3D12GraphicsCommandList.BeginQuery) |
| ID3D12GraphicsCommandList::ClearDepthStencilView Borra el recurso de galería de símbolos de profundidad. (ID3D12GraphicsCommandList.ClearDepthStencilView) |
| ID3D12GraphicsCommandList::ClearRenderTargetView Establece todos los elementos de un destino de representación en un valor. |
| ID3D12GraphicsCommandList::ClearState Restablece el estado de una lista de comandos directos al estado en el que se encontraba cuando se creó la lista de comandos. (ID3D12GraphicsCommandList.ClearState) |
| ID3D12GraphicsCommandList::ClearUnorderedAccessViewFloat Establece todos los elementos de una vista de acceso desordenado en los valores float especificados. |
| ID3D12GraphicsCommandList::ClearUnorderedAccessViewUint Establece todos los elementos de una vista de acceso sin ordenar (UAV) en los valores enteros especificados. |
| ID3D12GraphicsCommandList::Close Indica que la grabación en la lista de comandos ha finalizado. (ID3D12GraphicsCommandList.Close) |
| ID3D12GraphicsCommandList::CopyBufferRegion Copia una región de un búfer de un recurso a otro. |
| ID3D12GraphicsCommandList::CopyResource Copia todo el contenido del recurso de origen en el recurso de destino. |
| ID3D12GraphicsCommandList::CopyTextureRegion Este método usa la GPU para copiar datos de textura entre dos ubicaciones. Tanto el origen como el destino pueden hacer referencia a los datos de textura ubicados en un recurso de búfer o en un recurso de textura. |
| ID3D12GraphicsCommandList::CopyTiles Copia iconos del búfer en un recurso en mosaico o viceversa. (ID3D12GraphicsCommandList.CopyTiles) |
| ID3D12GraphicsCommandList::D iscardResource Descarta un recurso. |
| ID3D12GraphicsCommandList::D ispatch Ejecuta un sombreador de proceso en un grupo de subprocesos. |
| ID3D12GraphicsCommandList::D rawIndexedInstanced Dibuja primitivos indexados e instancias. |
| ID3D12GraphicsCommandList::D rawInstanced Dibuja primitivos no indexados y con instancias. |
| ID3D12GraphicsCommandList::EndEvent No se debe llamar a este método directamente. Use el entorno de ejecución de eventos PIX para insertar eventos en una lista de comandos. (ID3D12GraphicsCommandList.EndEvent) |
| ID3D12GraphicsCommandList::EndQuery Finaliza una consulta en ejecución. |
| ID3D12GraphicsCommandList::ExecuteBundle Ejecuta una agrupación. |
| ID3D12GraphicsCommandList::ExecuteIndirect Las aplicaciones realizan draws/dispatches indirectos mediante el método ExecuteIndirect. |
| ID3D12GraphicsCommandList::IASetIndexBuffer Establece la vista del búfer de índice. |
| ID3D12GraphicsCommandList::IASetPrimitiveTopology Enlace información sobre el tipo primitivo y el orden de datos que describe los datos de entrada para la fase del ensamblador de entrada. (ID3D12GraphicsCommandList.IASetPrimitiveTopology) |
| ID3D12GraphicsCommandList::IASetVertexBuffers Establece un identificador de descriptor de CPU para los búferes de vértices. |
| ID3D12GraphicsCommandList::OMSetBlendFactor Establece el factor de mezcla que modula los valores de un sombreador de píxeles, el destino de representación o ambos. |
| ID3D12GraphicsCommandList::OMSetRenderTargets Establece los identificadores de descriptor de CPU para los destinos de representación y la galería de símbolos de profundidad. |
| ID3D12GraphicsCommandList::OMSetStencilRef Establece el valor de referencia para las pruebas de galería de símbolos de profundidad. |
| ID3D12GraphicsCommandList::Reset Restablece una lista de comandos a su estado inicial como si se acaba de crear una nueva lista de comandos. (ID3D12GraphicsCommandList.Reset) |
| ID3D12GraphicsCommandList::ResolveQueryData Extrae datos de una consulta. ResolveQueryData funciona con todos los tipos de montón (valor predeterminado, carga y lectura diferida). ResolveQueryData funciona con todos los tipos de montón (valor predeterminado, carga y lectura diferida). . |
| ID3D12GraphicsCommandList::ResolveSubresource Copie un recurso de ejemplo múltiple en un recurso no muestreado. |
| ID3D12GraphicsCommandList::ResourceBarrier Notifica al controlador que necesita sincronizar varios accesos a los recursos. (ID3D12GraphicsCommandList.ResourceBarrier) |
| ID3D12GraphicsCommandList::RSSetScisorRects Enlaza una matriz de rectángulos de tijeras a la fase de rasterizador. |
| ID3D12GraphicsCommandList::RSSetViewports Enlace una matriz de ventanillas a la fase de rasterizador de la canalización. (ID3D12GraphicsCommandList.RSSetViewports) |
| ID3D12GraphicsCommandList::SetComputeRoot32BitConstant Establece una constante en la firma raíz de proceso. |
| ID3D12GraphicsCommandList::SetComputeRoot32BitConstants Establece un grupo de constantes en la firma raíz de proceso. |
| ID3D12GraphicsCommandList::SetComputeRootConstantBufferView Establece un identificador de descriptor de CPU para el búfer de constantes en la firma raíz de proceso. |
| ID3D12GraphicsCommandList::SetComputeRootDescriptorTable Establece una tabla descriptor en la firma raíz de proceso. |
| ID3D12GraphicsCommandList::SetComputeRootShaderResourceView Establece un identificador de descriptor de CPU para el recurso de sombreador en la firma raíz de proceso. |
| ID3D12GraphicsCommandList::SetComputeRootSignature Establece el diseño de la firma raíz de proceso. |
| ID3D12GraphicsCommandList::SetComputeRootUnorderedAccessView Establece un identificador de descriptor de CPU para el recurso unordered-access-view en la firma raíz de proceso. |
| ID3D12GraphicsCommandList::SetDescriptorHeaps Cambia los montones de descriptores enlazados actualmente asociados a una lista de comandos. |
| ID3D12GraphicsCommandList::SetGraphicsRoot32BitConstant Establece una constante en la firma raíz de gráficos. |
| ID3D12GraphicsCommandList::SetGraphicsRoot32BitConstants Establece un grupo de constantes en la firma raíz de gráficos. |
| ID3D12GraphicsCommandList::SetGraphicsRootConstantBufferView Establece un identificador de descriptor de CPU para el búfer de constantes en la firma raíz de gráficos. |
| ID3D12GraphicsCommandList::SetGraphicsRootDescriptorTable Establece una tabla descriptor en la firma raíz de gráficos. |
| ID3D12GraphicsCommandList::SetGraphicsRootShaderResourceView Establece un identificador de descriptor de CPU para el recurso de sombreador en la firma raíz de gráficos. |
| ID3D12GraphicsCommandList::SetGraphicsRootSignature Establece el diseño de la firma raíz de gráficos. |
| ID3D12GraphicsCommandList::SetGraphicsRootUnorderedAccessView Establece un identificador de descriptor de CPU para el recurso unordered-access-view en la firma raíz de gráficos. |
| ID3D12GraphicsCommandList::SetMarker No se debe llamar a este método directamente. Use el entorno de ejecución de eventos PIX para insertar eventos en una lista de comandos. (ID3D12GraphicsCommandList.SetMarker) |
| ID3D12GraphicsCommandList::SetPipelineState Establece todos los sombreadores y programas la mayor parte del estado de función fija de la canalización de la unidad de procesamiento gráfico (GPU). |
| ID3D12GraphicsCommandList::SetPredication Establece un predicado de representación. |
| ID3D12GraphicsCommandList::SOSetTargets Establece las vistas del búfer de salida de flujo. |
Comentarios
Esta interfaz es nueva en D3D12, encapsulando gran parte de la funcionalidad de la interfaz ID3D11CommandList e incluye la nueva funcionalidad descrita en Representación.
Ejemplos
El ejemplo D3D12nBodyGravity usa ID3D12GraphicsCommandList de la siguiente manera:
Declare los objetos de canalización.
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;
Rellenar listas de comandos.
// Fill the command list with all the render commands and dependent state.
void D3D12nBodyGravity::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_commandAllocators[m_frameIndex]->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_commandAllocators[m_frameIndex].Get(), m_pipelineState.Get()));
// Set necessary state.
m_commandList->SetPipelineState(m_pipelineState.Get());
m_commandList->SetGraphicsRootSignature(m_rootSignature.Get());
m_commandList->SetGraphicsRootConstantBufferView(RootParameterCB, m_constantBufferGS->GetGPUVirtualAddress() + m_frameIndex * sizeof(ConstantBufferGS));
ID3D12DescriptorHeap* ppHeaps[] = { m_srvUavHeap.Get() };
m_commandList->SetDescriptorHeaps(_countof(ppHeaps), ppHeaps);
m_commandList->IASetVertexBuffers(0, 1, &m_vertexBufferView);
m_commandList->IASetPrimitiveTopology(D3D_PRIMITIVE_TOPOLOGY_POINTLIST);
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.0f, 0.1f, 0.0f };
m_commandList->ClearRenderTargetView(rtvHandle, clearColor, 0, nullptr);
// Render the particles.
float viewportHeight = static_cast<float>(static_cast<UINT>(m_viewport.Height) / m_heightInstances);
float viewportWidth = static_cast<float>(static_cast<UINT>(m_viewport.Width) / m_widthInstances);
for (UINT n = 0; n < ThreadCount; n++)
{
const UINT srvIndex = n + (m_srvIndex[n] == 0 ? SrvParticlePosVelo0 : SrvParticlePosVelo1);
D3D12_VIEWPORT viewport;
viewport.TopLeftX = (n % m_widthInstances) * viewportWidth;
viewport.TopLeftY = (n / m_widthInstances) * viewportHeight;
viewport.Width = viewportWidth;
viewport.Height = viewportHeight;
viewport.MinDepth = D3D12_MIN_DEPTH;
viewport.MaxDepth = D3D12_MAX_DEPTH;
m_commandList->RSSetViewports(1, &viewport);
CD3DX12_GPU_DESCRIPTOR_HANDLE srvHandle(m_srvUavHeap->GetGPUDescriptorHandleForHeapStart(), srvIndex, m_srvUavDescriptorSize);
m_commandList->SetGraphicsRootDescriptorTable(RootParameterSRV, srvHandle);
m_commandList->DrawInstanced(ParticleCount, 1, 0, 0);
}
m_commandList->RSSetViewports(1, &m_viewport);
// 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());
}
Consulte el código de ejemplo en la referencia D3D12.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | d3d12.h |