Método ID3D12GraphicsCommandList4::ExecuteMetaCommand (d3d12.h)

Registra a execução (ou invocação) do comando meta especificado em uma lista de comandos gráficos.

Chame ID3D12GraphicsCommandList4::InitializeMetaCommand antes de executar um comando meta. Durante a invocação, você pode especificar substituições para valores de qualquer um dos parâmetros de runtime. Você pode executar vários metadados na mesma lista de comandos gráficos. E você pode executar o mesmo comando meta várias vezes na mesma lista de comandos.

Com uma captura de PIX obtida com o uso de metadados, você pode reproduzi-la novamente na mesma configuração de hardware. Mas, por design, não é portátil para outras GPUs.

Sintaxe

void ExecuteMetaCommand(
  [in]           ID3D12MetaCommand *pMetaCommand,
  [in, optional] const void        *pExecutionParametersData,
  [in]           SIZE_T            ExecutionParametersDataSizeInBytes
);

Parâmetros

[in] pMetaCommand

Um ponteiro para um ID3D12MetaCommand que representa o comando meta a ser inicializado.

[in, optional] pExecutionParametersData

Um ponteiro opcional para uma estrutura constante que contém os valores dos parâmetros para executar o comando meta.

[in] ExecutionParametersDataSizeInBytes

Um SIZE_T que contém o tamanho da estrutura apontada por pExecutionParametersData, se definido, caso contrário, 0.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Seu aplicativo é responsável por configurar os recursos fornecidos para um comando meta no estado necessário de acordo com a especificação de metadados. A especificação de definição de metadados define o estado de recurso esperado para cada parâmetro. Seu aplicativo é responsável por inserir barreiras de UAV (exibição de acesso não ordenada) para recursos de entrada antes que o algoritmo do comando meta possa consumi-las. Você também é responsável por inserir a barreira UAV para os recursos de saída quando pretende lê-los novamente.

Durante uma invocação de algoritmo, o driver pode inserir quantas barreiras UAV para os recursos de saída forem necessárias para sincronizar o uso do recurso de saída na implementação do algoritmo. Do ponto de vista do aplicativo, você deve assumir que todos os recursos de entrada e saída são gravados pelo comando meta, incluindo memória de rascunho.

Requisitos

Confira também

ID3D12GraphicsCommandList4