ID3D12GraphicsCommandList::ClearState method

Resets the state of a direct command list back to the state it was in when the command list was created.

Syntax

void ClearState(
  [in, optional] ID3D12PipelineState *pPipelineState
);

Parameters

pPipelineState [in, optional]

Type: ID3D12PipelineState*

A pointer to the ID3D12PipelineState object that contains the initial pipeline state for the command list.

Return value

Returns nothing.

Remarks

It is invalid to call ClearState on a bundle. If an app calls ClearState on a bundle, the call to Close will return E_FAIL.

When ClearState is called, all currently bound resources are unbound. The primitive topology is set to D3D_PRIMITIVE_TOPOLOGY_UNDEFINED. Viewports, scissor rectangles, stencil reference value, and the blend factor are set to empty values (all zeros). Predication is disabled.

The app-provided pipeline state object becomes bound as the currently set pipeline state object.

Requirements

See also

ID3D12GraphicsCommandList