ID3D12Device2::CreatePipelineState-Methode (d3d12.h)

  • Artikel

Erstellt ein Pipelinezustandsobjekt aus einer Beschreibung des Pipelinestatusdatenstroms.

Syntax

HRESULT CreatePipelineState(
        const D3D12_PIPELINE_STATE_STREAM_DESC *pDesc,
        REFIID                                 riid,
  [out] void                                   **ppPipelineState
);

Parameter

pDesc

Typ: const D3D12_PIPELINE_STATE_STREAM_DESC*

Die Adresse einer D3D12_PIPELINE_STATE_STREAM_DESC Struktur, die den Pipelinestatus beschreibt.

riid

Typ: REFIID

Der globally unique Identifier (GUID) für die Pipelinestatusschnittstelle (ID3D12PipelineState).

Die REFIID oder GUID der Schnittstelle zum Pipelinestatus kann mithilfe des Makros __uuidof() abgerufen werden. Beispielsweise ruft __uuidof(ID3D12PipelineState) die GUID der Schnittstelle in einen Pipelinezustand ab.

[out] ppPipelineState

Typ: void**

SAL: COM_Outptr

Ein Zeiger auf einen Speicherblock, der einen Zeiger auf die ID3D12PipelineState-Schnittstelle für das Pipelinestatusobjekt empfängt.

Das Pipelinezustandsobjekt ist ein unveränderliches Zustandsobjekt. Es enthält keine Methoden.

Rückgabewert

Typ: HRESULT

Diese Methode gibt E_OUTOFMEMORY zurück, wenn nicht genügend Arbeitsspeicher zum Erstellen des Pipelinezustandsobjekts vorhanden ist. Weitere mögliche Rückgabewerte finden Sie unter Direct3D 12-Rückgabecodes .

Hinweise

Diese Funktion verwendet die Pipelinebeschreibung als D3D12_PIPELINE_STATE_STREAM_DESC und kombiniert die Funktionalität der Funktionen ID3D12Device::CreateGraphicsPipelineState und ID3D12Device::CreateComputePipelineState , die ihre Pipelinebeschreibung als weniger flexible D3D12_GRAPHICS_PIPELINE_STATE_DESC - bzw . D3D12_COMPUTE_PIPELINE_STATE_DESC-Strukturen verwenden.

Anforderungen

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

Weitere Informationen

Eine Beschreibung des Layouts und Verhaltens einer Streamingpipeline desc finden Sie unter D3D12_PIPELINE_STATE_STREAM_DESC .

ID3D12Device2