Metodo ID3D11DeviceContext::ExecuteCommandList (d3d11.h)
Comandi delle code da un elenco di comandi in un dispositivo.
Sintassi
void ExecuteCommandList(
[in] ID3D11CommandList *pCommandList,
BOOL RestoreContextState
);
Parametri
[in] pCommandList
Tipo: ID3D11CommandList*
Puntatore a un'interfaccia ID3D11CommandList che incapsula un elenco di comandi.
RestoreContextState
Tipo: BOOL
Flag booleano che determina se lo stato del contesto di destinazione viene salvato prima e ripristinato dopo l'esecuzione di un elenco di comandi. Usare TRUE per indicare che il runtime deve salvare e ripristinare lo stato. Usare FALSE per indicare che non verrà salvato o ripristinato alcun stato, che causa la restituzione del contesto di destinazione allo stato predefinito dopo l'esecuzione dell'elenco di comandi. Le applicazioni devono in genere usare FALSE a meno che non ripristinino lo stato per essere quasi equivalente allo stato che il runtime ripristina se TRUE è stato passato. Quando le applicazioni usano FALSE, possono evitare transizioni di stato inutili e inefficienti.
Valore restituito
nessuno
Osservazioni
Usare questo metodo per riprodurre un elenco di comandi registrato da un contesto posticipato in qualsiasi thread.
È necessaria una chiamata a ExecuteCommandList di un elenco di comandi da un contesto posticipato nel contesto immediato per l'esecuzione dei comandi registrati nell'unità di elaborazione grafica (GPU). Una chiamata a ExecuteCommandList di un elenco di comandi da un contesto posticipato a un altro contesto posticipato può essere usata per unire elenchi registrati. Tuttavia, per eseguire i comandi dall'elenco di comandi posticipato unito nella GPU, è necessario eseguirli nel contesto immediato.
Questo metodo esegue una convalida del runtime correlata alle query. Non è possibile modificare indirettamente le query avviate in un contesto del dispositivo eseguendo un elenco di comandi, ovvero Begin o End, richiamato sulla stessa query dal contesto posticipato che ha generato l'elenco dei comandi. Se si verifica una condizione di questo tipo, il metodo ExecuteCommandList non esegue l'elenco di comandi. Tuttavia, lo stato del contesto del dispositivo viene ancora mantenuto, come previsto (ID3D11DeviceContext::ClearState , a meno che l'applicazione non indichi di mantenere lo stato del contesto del dispositivo).
Windows Phone 8: questa API è supportata.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | d3d11.h |
| Libreria | D3d11.lib |