ID3D12GraphicsCommandList::ClearState-Methode (d3d12.h)

Setzt den Status einer direkten Befehlsliste wieder auf den Zustand zurück, in dem sie sich befand, als die Befehlsliste erstellt wurde.

Syntax

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

Parameter

[in, optional] pPipelineState

Typ: ID3D12PipelineState*

Ein Zeiger auf das ID3D12PipelineState-Objekt , das den anfänglichen Pipelinestatus für die Befehlsliste enthält.

Rückgabewert

Keine

Bemerkungen

Es ist ungültig, ClearState in einem Bundle aufzurufen. Wenn eine App ClearState in einem Bundle aufruft, gibt der Aufruf von CloseE_FAIL zurück.

Wenn ClearState aufgerufen wird, sind alle derzeit gebundenen Ressourcen ungebunden. Die primitive Topologie ist auf D3D_PRIMITIVE_TOPOLOGY_UNDEFINED festgelegt. Viewports, Scherenrechtecke, Schablonenverweiswert und der Mischfaktor werden auf leere Werte (alle Nullen) festgelegt. Die Prädication ist deaktiviert.

Das von der App bereitgestellte Pipelinestatusobjekt wird als aktuell festgelegtes Pipelinestatusobjekt gebunden.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	d3d12.h
Bibliothek	D3D12.lib
DLL	D3D12.dll

Weitere Informationen

ID3D12GraphicsCommandList