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

Vedi anche

ID3D11DeviceContext