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

Enfileira comandos de uma lista de comandos em um dispositivo.

Sintaxe

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

Parâmetros

[in] pCommandList

Tipo: ID3D11CommandList*

Um ponteiro para uma interface ID3D11CommandList que encapsula uma lista de comandos.

RestoreContextState

Tipo: BOOL

Um sinalizador booliano que determina se o estado de contexto de destino é salvo antes e restaurado após a execução de uma lista de comandos. Use TRUE para indicar que o runtime precisa salvar e restaurar o estado. Use FALSE para indicar que nenhum estado deve ser salvo ou restaurado, o que faz com que o contexto de destino retorne ao estado padrão após a execução da lista de comandos. Os aplicativos normalmente devem usar FALSE , a menos que restaurem o estado para ser quase equivalente ao estado que o runtime restauraria se TRUE fosse passado. Quando os aplicativos usam FALSE, eles podem evitar transições de estado desnecessárias e ineficientes.

Retornar valor

Nenhum

Comentários

Use esse método para reproduzir uma lista de comandos que foi registrada por um contexto adiado em qualquer thread.

Uma chamada para ExecuteCommandList de uma lista de comandos de um contexto adiado para o contexto imediato é necessária para que os comandos gravados sejam executados na GPU (unidade de processamento gráfico). Uma chamada para ExecuteCommandList de uma lista de comandos de um contexto adiado para outro contexto adiado pode ser usada para mesclar listas registradas. Mas para executar os comandos na lista de comandos adiados mesclados na GPU, você precisa executá-los no contexto imediato.

Esse método executa alguma validação de runtime relacionada a consultas. As consultas iniciadas em um contexto de dispositivo não podem ser manipuladas indiretamente executando uma lista de comandos (ou seja, Begin ou End foi invocado na mesma consulta pelo contexto adiado que gerou a lista de comandos). Se essa condição ocorrer, o método ExecuteCommandList não executará a lista de comandos. No entanto, o estado do contexto do dispositivo ainda é mantido, como seria esperado (ID3D11DeviceContext::ClearState é executado, a menos que o aplicativo indique preservar o estado de contexto do dispositivo).

Windows Phone 8: há suporte para essa API.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	d3d11.h
Biblioteca	D3d11.lib

Confira também

ID3D11DeviceContext