Metodo ID3D12PipelineLibrary1::LoadPipeline (d3d12.h)

Recupera l'oggetto PSO richiesto dalla libreria. La descrizione del flusso della pipeline viene confrontata con il database della libreria e ricordata per evitare la duplicazione dei contenuti PSO.

Sintassi

HRESULT LoadPipeline(
  [in]  LPCWSTR                                pName,
  [in]  const D3D12_PIPELINE_STATE_STREAM_DESC *pDesc,
        REFIID                                 riid,
  [out] void                                   **ppPipelineState
);

Parametri

[in] pName

Tipo: LPCWSTR

SAL: In

Nome univoco dell'oggetto PSO.

[in] pDesc

Tipo: const D3D12_PIPELINE_STATE_STREAM_DESC*

SAL: In

Descrive l'oggetto PSO richiesto usando una struttura D3D12_PIPELINE_STATE_STREAM_DESC . Questa descrizione viene confrontata con il database della libreria e archiviata per evitare la duplicazione dei contenuti PSO.

riid

Tipo: REFIID

Specifica un REFIID per l'oggetto ID3D12PipelineState .

L'app deve in genere impostare questo argomento e l'argomento seguente, ppPipelineState, usando la macro IID_PPV_ARGS(&PSO1), dove PSO1 è il nome dell'oggetto.

[out] ppPipelineState

Tipo: void**

SAL: COM_Outptr

Specifica il puntatore che farà riferimento all'oggetto PSO dopo che la funzione restituisce correttamente.

Valore restituito

Tipo: HRESULT

Questo metodo restituisce un codice di esito positivo o di errore HRESULT, che può includere E_INVALIDARG se il nome non esiste o la descrizione del flusso non corrisponde ai dati nella libreria e E_OUTOFMEMORY se la funzione non è in grado di allocare il PSO risultante.

Commenti

Questa funzione accetta la descrizione della pipeline come D3D12_PIPELINE_STATE_STREAM_DESC ed è una sostituzione per le funzioni ID3D12PipelineLibrary::LoadGraphicsPipeline e ID3D12PipelineLibrary::LoadComputePipeline , che accettano rispettivamente la descrizione della pipeline come D3D12_GRAPHICS_PIPELINE_STATE_DESC meno flessibili eD3D12_COMPUTE_PIPELINE_STATE_DESC struct.

Requisiti

Vedi anche

Per una descrizione del layout e del comportamento di una pipeline di streaming, vedere D3D12_PIPELINE_STATE_STREAM_DESC .

ID3D12PipelineLibrary1