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 |