Метод ID3D12GraphicsCommandList4::ExecuteMetaCommand (d3d12.h)

Статья
08/23/2023

Записывает выполнение (или вызов) указанной метакоманды в графический список команд.

Вызовите ID3D12GraphicsCommandList4::InitializeMetaCommand перед выполнением мета-команды. Во время вызова можно указать переопределения для значений любого из параметров среды выполнения. Вы можете выполнить несколько метакоманд в одном списке команд графики. И вы можете выполнить одну и ту же метакоманду несколько раз в одном списке команд.

С помощью записи PIX, взятой с помощью метакоманд, вы можете воспроизвести их в той же конфигурации оборудования. Но по умолчанию он не переносится на другие GPU.

Синтаксис

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

Параметры

[in] pMetaCommand

Указатель на ID3D12MetaCommand , представляющий метакоманд для инициализации.

[in, optional] pExecutionParametersData

Необязательный указатель на константную структуру, содержащую значения параметров для выполнения метакоманды.

[in] ExecutionParametersDataSizeInBytes

SIZE_T, содержащий размер структуры, на которую указывает pExecutionParametersData, если задано, в противном случае — 0.

Возвращаемое значение

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Ваше приложение отвечает за настройку ресурсов, предоставленных мета-команде, в состоянии, требуемом в соответствии со спецификацией метакоманд. Спецификация определения метакоманд определяет ожидаемое состояние ресурса для каждого параметра. Приложение отвечает за вставку барьеров неупорядоченного представления доступа (UAV) для входных ресурсов, прежде чем алгоритм метакоманд сможет их использовать. Вы также отвечаете за вставку барьера UAV для выходных ресурсов, когда планируете считывать их обратно.

Во время вызова алгоритма драйвер может вставить столько барьеров UAV для выходных ресурсов, сколько необходимо для синхронизации использования выходных ресурсов в реализации алгоритма. С точки зрения вашего приложения следует предположить, что все исходящие и исходящие ресурсы записываются в метакоманд, включая временные ресурсы.

Требования

Требование	Значение
Целевая платформа	Windows
Header	d3d12.h

См. также раздел

ID3D12GraphicsCommandList4

Поделиться через