ID3D11DeviceContext::ExecuteCommandList Method

Queues commands from a command list onto a device.

Syntax

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

Parameter

• pCommandList [in]
  Typ: ID3D11CommandList*

  A pointer to an ID3D11CommandList interface that encapsulates a command list.

• RestoreContextState [in]
  Typ: BOOL

  A Boolean flag that determines whether the immediate context state is saved prior to and restored after the execution of a command list. Use TRUE to indicate that the runtime needs to save and restore the state. Use FALSE to indicate that no state shall be saved or restored, which causes the immediate context to return to its default state after the command list executes. Applications should typically use FALSE unless they will restore the state to be nearly equivalent to the state that the runtime would restore if TRUE were passed. When applications use FALSE, they can avoid unnecessary and inefficient state transitions.

Rückgabewert

Methode gibt keinen Wert zurück.

Hinweise

Use this method to play back a command list that was recorded by a deferred context on any thread.

This method performs some runtime validation related to queries. Queries that are begun in a device context cannot be manipulated indirectly by executing a command list (that is, Begin or End was invoked against the same query by the deferred context which generated the command list). If such a condition occurs, the ExecuteCommandList method does not execute the command list. However, the state of the device context is still maintained, as would be expected (ID3D11DeviceContext::ClearState is performed, unless the application indicates to preserve the device context state).

Anforderungen

Siehe auch

ID3D11DeviceContext