Compartir a través de


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

Registra la ejecución (o invocación) del meta comando especificado en una lista de comandos de gráficos.

Llame a ID3D12GraphicsCommandList4::InitializeMetaCommand antes de ejecutar un metacomando. Durante la invocación, puede especificar invalidaciones para los valores de cualquiera de los parámetros en tiempo de ejecución. Puede ejecutar varios metacomandos en la misma lista de comandos gráficos. Y puede ejecutar el mismo metacomando varias veces en la misma lista de comandos.

Con una captura PIX tomada con el uso de metacomandos, puede reproducirla en la misma configuración de hardware. Pero, por diseño, no es portátil para otras GPU.

Sintaxis

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

Parámetros

[in] pMetaCommand

Puntero a un id3D12MetaCommand que representa el meta comando que se va a inicializar.

[in, optional] pExecutionParametersData

Puntero opcional a una estructura constante que contiene los valores de los parámetros para ejecutar el metacomando.

[in] ExecutionParametersDataSizeInBytes

Un SIZE_T que contiene el tamaño de la estructura a la que apunta pExecutionParametersData, si se establece, en caso contrario, 0.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

La aplicación es responsable de configurar los recursos proporcionados a un metacomando en el estado requerido según la especificación del metacomando. La especificación de definición de metacomando define el estado de recurso esperado para cada parámetro. La aplicación es responsable de insertar barreras de la vista de acceso desordenada (UAV) para los recursos de entrada antes de que el algoritmo del meta comando pueda consumirlos. También es responsable de insertar la barrera UAV para los recursos de salida cuando piensa leerlos de nuevo.

Durante una invocación de algoritmo, el controlador puede insertar tantas barreras de UAV para los recursos de salida como sea necesario para sincronizar el uso de recursos de salida en la implementación del algoritmo. Desde el punto de vista de la aplicación, debe suponer que el meta comando escribe todos los recursos fuera y fuera, incluida la memoria temporal.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado d3d12.h

Consulte también

ID3D12GraphicsCommandList4