Método ID3D11DeviceContext::ExecuteCommandList (d3d11.h)
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 |