struttura CD3DX12_PIPELINE_STATE_STREAM

Articolo
01/10/2024

Struttura helper per la creazione e l'uso degli stati della pipeline grafica e di calcolo tramite un'interfaccia combinata. Vedere D3D12_GRAPHICS_PIPELINE_STATE_DESC e D3D12_COMPUTE_PIPELINE_STATE_DESC.

CD3DX12_PIPELINE_STATE_STREAM supporta Windows 10 Creators Update e versioni successive, ma non supporta nuove funzionalità dell'aggiornamento di Fall Creators, ad esempio la creazione di istanze di visualizzazione. Per supportare le funzionalità dell'aggiornamento fall Creators, usare CD3DX12_PIPELINE_STATE_STREAM1 .

Sintassi

struct CD3DX12_PIPELINE_STATE_STREAM {
  CD3DX12_PIPELINE_STATE_STREAM                       CD3DX12_PIPELINE_STATE_STREAM();
  CD3DX12_PIPELINE_STATE_STREAM                       CD3DX12_PIPELINE_STATE_STREAM(const D3D12_GRAPHICS_PIPELINE_STATE_DESC& Desc);
  CD3DX12_PIPELINE_STATE_STREAM                       CD3DX12_PIPELINE_STATE_STREAM(const D3D12_COMPUTE_PIPELINE_STATE_DESC& Desc);
  D3D12_GRAPHICS_PIPELINE_STATE_DESC                  GraphicsDescV0();
  D3D12_COMPUTE_PIPELINE_STATE_DESC                   ComputeDescV0();
  CD3DX12_PIPELINE_STATE_STREAM_FLAGS                 Flags;
  CD3DX12_PIPELINE_STATE_STREAM_NODE_MASK             NodeMask;
  CD3DX12_PIPELINE_STATE_STREAM_ROOT_SIGNATURE        pRootSignature;
  CD3DX12_PIPELINE_STATE_STREAM_INPUT_LAYOUT          InputLayout;
  CD3DX12_PIPELINE_STATE_STREAM_IB_STRIP_CUT_VALUE    IBStripCutValue;
  CD3DX12_PIPELINE_STATE_STREAM_PRIMITIVE_TOPOLOGY    PrimitiveTopologyType;
  CD3DX12_PIPELINE_STATE_STREAM_VS                    VS;
  CD3DX12_PIPELINE_STATE_STREAM_GS                    GS;
  CD3DX12_PIPELINE_STATE_STREAM_STREAM_OUTPUT         StreamOutput;
  CD3DX12_PIPELINE_STATE_STREAM_HS                    HS;
  CD3DX12_PIPELINE_STATE_STREAM_DS                    DS;
  CD3DX12_PIPELINE_STATE_STREAM_PS                    PS;
  CD3DX12_PIPELINE_STATE_STREAM_CS                    CS;
  CD3DX12_PIPELINE_STATE_STREAM_BLEND_DESC            BlendState;
  CD3DX12_PIPELINE_STATE_STREAM_DEPTH_STENCIL1        DepthStencilState;
  CD3DX12_PIPELINE_STATE_STREAM_DEPTH_STENCIL_FORMAT  DSVFormat;
  CD3DX12_PIPELINE_STATE_STREAM_RASTERIZER            RasterizerState;
  CD3DX12_PIPELINE_STATE_STREAM_RENDER_TARGET_FORMATS RTVFormats;
  CD3DX12_PIPELINE_STATE_STREAM_SAMPLE_DESC           SampleDesc;
  CD3DX12_PIPELINE_STATE_STREAM_SAMPLE_MASK           SampleMask;
  CD3DX12_PIPELINE_STATE_STREAM_CACHED_PSO            CachedPSO;
};

Membri

CD3DX12_PIPELINE_STATE_STREAM(): Crea una nuova istanza non inizializzata di un CD3DX12_PIPELINE_STATE_STREAM.
CD3DX12_PIPELINE_STATE_STREAM(const D3D12_GRAPHICS_PIPELINE_STATE_DESC& Desc): Crea una nuova istanza di un CD3DX12_PIPELINE_STATE_STREAM, inizializzata con valori copiati da una struttura CD3DX12_PIPELINE_STATE_STREAM .
CD3DX12_PIPELINE_STATE_STREAM(const D3D12_COMPUTE_PIPELINE_STATE_DESC& Desc): Crea una nuova istanza di un CD3DX12_PIPELINE_STATE_STREAM, inizializzata con valori copiati da una struttura CD3DX12_PIPELINE_STATE_STREAM .
GraphicsDescV0(): restituisce il contenuto dell'oggetto CD3DX12_PIPELINE_STATE_STREAM come struttura D3D12_GRAPHICS_PIPELINE_STATE_DESC per valore. Si noti che D3D12_GRAPHICS_PIPELINE_STATE_DESC non include il membro CS , quindi questo valore viene perso nella conversione.
ComputeDescV0(): restituisce il contenuto dell'oggetto CD3DX12_PIPELINE_STATE_STREAM come struttura D3D12_COMPUTE_PIPELINE_STATE_DESC per valore. Si noti che D3D12_COMPUTE_PIPELINE_STATE_DESC non include InputLayout, IBStripCutValue, PrimitiveTopologyType, VS, GS, StreamOutput, HS, DS, PS, BlendState, DepthStencilState, DSVFormat, RasterizerState, NumRootSignature, RTVFormats, SampleDesc o SampleMask membri, quindi questi valori vengono persi nella conversione.
Flag: Descrive i flag di stato della pipeline, che controllano funzionalità come "debug degli strumenti".
Maschera di nodo: Descrive la maschera del nodo dello stato della pipeline, usata per identificare i nodi (adattatori fisici del dispositivo) a cui si applica l'oggetto PSO negli scenari multi-adapter; ogni bit nella maschera corrisponde a un singolo nodo. Per gli scenari a adattatore singolo, impostare questo valore su 0.
pRootSignature: Descrive la firma radice.
InputLayout: Descrive il formato del buffer di input per la fase input-assembler
IBStripCutValue: Descrive il valore di indice speciale del buffer di input che indica un taglio (discontinuità) quando si usa la topologia con striping di triangoli.
PrimitiveTopologyType: Descrive la topologia primitiva e il relativo ordine.
VS: Descrive il vertex shader.
GS: Descrive lo shader geometry.
StreamOutput: Descrive il buffer di output di streaming.
HS: Descrive lo hull shader.
DS: Descrive lo shader di dominio.
PS: Descrive il pixel shader.
CS: Descrive lo shader di calcolo.
BlendState: Descrive lo stato della fusione.
DepthStencilState: Descrive lo stato depth-stencil.
DSVFormat: Descrive il formato depth-stencil.
RasterizerState: Descrive lo stato del rasterizzatore.
RTVFormats: Descrive i formati di destinazione di rendering.
SampleDesc: Descrive il conteggio e la qualità dei campioni.
Maschera di esempio: Descrive la maschera di esempio usata con lo stato di fusione.
CachedPSO: Descrive un pso memorizzato nella cache.

Osservazioni:

CD3DX12_PIPELINE_STATE_STREAM supporta Windows 10 Creators Update e versioni successive, ma non supporta i tipi di oggetto secondario aggiunti in Windows 10 Fall Creators Update, ad esempio per la creazione di istanze di visualizzazione. Per supportare i tipi di oggetto secondario aggiunti nell'aggiornamento fall Creators, usare CD3DX12_PIPELINE_STATE_STREAM1 .

Le variabili membro accessibili di questa struttura sono tutte typedef del modello di CD3DX12_PIPELINE_STATE_STREAM_SUBOBJECT, che combina i dati del tipo di oggetto secondario e del sottooggetto in un singolo oggetto adatto per una descrizione del flusso.

Tali typedef sono:

Requisiti

Requisito	Valore
Intestazione	D3dx12.h

Vedi anche

Strutture helper per D3D12
CD3DX12_PIPELINE_STATE_STREAM1
D3D12_GRAPHICS_PIPELINE_STATE_DESC
D3D12_COMPUTE_PIPELINE_STATE_DESC

Share via