Método ID3D11DeviceContext::ExecuteCommandList (d3d11.h)

  • Artículo

Pone en cola los comandos de una lista de comandos en un dispositivo.

Sintaxis

void ExecuteCommandList(
  [in] ID3D11CommandList *pCommandList,
       BOOL              RestoreContextState
);

Parámetros

[in] pCommandList

Tipo: ID3D11CommandList*

Puntero a una interfaz ID3D11CommandList que encapsula una lista de comandos.

RestoreContextState

Tipo: BOOL

Marca booleana que determina si el estado de contexto de destino se guarda antes y se restaura después de la ejecución de una lista de comandos. Use TRUE para indicar que el tiempo de ejecución debe guardar y restaurar el estado. Use FALSE para indicar que no se guardará ni restaurará ningún estado, lo que hace que el contexto de destino vuelva a su estado predeterminado después de que se ejecute la lista de comandos. Normalmente, las aplicaciones deben usar FALSE a menos que restauren el estado para que sea casi equivalente al estado que el tiempo de ejecución restauraría si se pasara TRUE . Cuando las aplicaciones usan FALSE, pueden evitar transiciones de estado innecesarias e ineficaces.

Valor devuelto

None

Observaciones

Use este método para reproducir una lista de comandos grabada por un contexto diferido en cualquier subproceso.

Se requiere una llamada a ExecuteCommandList de una lista de comandos de un contexto diferido en el contexto inmediato para que los comandos grabados se ejecuten en la unidad de procesamiento gráfico (GPU). Se puede usar una llamada a ExecuteCommandList de una lista de comandos de un contexto diferido en otro contexto diferido para combinar listas grabadas. Pero para ejecutar los comandos de la lista de comandos diferidos combinados en la GPU, debe ejecutarlos en el contexto inmediato.

Este método realiza alguna validación en tiempo de ejecución relacionada con las consultas. Las consultas que se inician en un contexto de dispositivo no se pueden manipular indirectamente mediante la ejecución de una lista de comandos (es decir, Begin o End se invocó en la misma consulta mediante el contexto diferido que generó la lista de comandos). Si se produce esta condición, el método ExecuteCommandList no ejecuta la lista de comandos. Sin embargo, el estado del contexto del dispositivo se mantiene, como se esperaría (ID3D11DeviceContext::ClearState se realiza, a menos que la aplicación indique que conserva el estado del contexto del dispositivo).

Windows Phone 8: se admite esta API.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado d3d11.h
Library D3d11.lib

Consulte también

ID3D11DeviceContext