ID3D12GraphicsCommandList4::ExecuteMetaCommand 方法 (d3d12.h)

将指定的元命令的执行 (或调用) 记录到图形命令列表中。

在执行元命令之前,调用 ID3D12GraphicsCommandList4::InitializeMetaCommand 。 在调用期间,可以为任何运行时参数的值指定替代。 可以在同一图形命令列表中执行多个元命令。 可以在同一命令列表中多次执行同一元命令。

使用元命令获取 PIX 捕获后,可以在同一硬件配置上播放该捕获。 但是,根据设计,它不能移植到其他 GPU。

语法

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

参数

[in] pMetaCommand

指向 ID3D12MetaCommand 的 指针,表示要初始化的元命令。

[in, optional] pExecutionParametersData

指向常量结构的可选指针,其中包含用于执行 meta 命令的参数的值。

[in] ExecutionParametersDataSizeInBytes

包含 pExecutionParametersData 指向的结构大小的SIZE_T(如果已设置),否则为 0。

返回值

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

应用程序负责根据元命令规范以所需的状态设置提供给元命令的资源。 元命令定义规范定义了每个参数的预期资源状态。 应用程序负责插入无序访问视图 (UAV) 输入资源的障碍,然后才能使用元命令的算法。 你还负责在打算读回输出资源时插入输出资源的 UAV 屏障。

在算法调用期间,驱动程序可能会根据需要为输出资源插入任意数量的 UAV 屏障,以同步算法实现中的输出资源使用情况。 从应用程序的角度来看,应假定所有输出和传入/输出资源都由元命令写入,包括暂存内存。

要求

要求
目标平台 Windows
标头 d3d12.h

另请参阅

ID3D12GraphicsCommandList4