ID3D12PipelineLibrary1::LoadPipeline-Methode (d3d12.h)

Artikel
02/29/2024

Ruft den angeforderten PSO aus der Bibliothek ab. Die Beschreibung des Pipelinedatenstroms wird mit der Bibliotheksdatenbank abgeglichen und gespeichert, um duplizierte PSO-Inhalte zu verhindern.

Syntax

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

Parameter

[in] pName

Typ: LPCWSTR

SAL: In

Der eindeutige Name des PSO.

[in] pDesc

Typ: const D3D12_PIPELINE_STATE_STREAM_DESC*

SAL: In

Beschreibt den erforderlichen PSO unter Verwendung einer D3D12_PIPELINE_STATE_STREAM_DESC-Struktur . Diese Beschreibung wird mit der Bibliotheksdatenbank abgeglichen und gespeichert, um eine Duplizierung von PSO-Inhalten zu verhindern.

riid

Typ: REFIID

Gibt eine REFIID für das ID3D12PipelineState-Objekt an.

Ihre App sollte in der Regel dieses Argument und das folgende Argument ppPipelineState mithilfe des Makros IID_PPV_ARGS(&PSO1) festlegen, wobei PSO1 der Name des Objekts ist.

[out] ppPipelineState

Typ: void**

SAL: COM_Outptr

Gibt den Zeiger an, der auf den PSO verweist, nachdem die Funktion erfolgreich zurückgegeben wurde.

Rückgabewert

Typ: HRESULT

Diese Methode gibt einen HRESULT-Erfolgs- oder Fehlercode zurück, der E_INVALIDARG enthalten kann, wenn der Name nicht vorhanden ist oder die Streambeschreibung nicht mit den Daten in der Bibliothek übereinstimmt, und E_OUTOFMEMORY, wenn die Funktion den resultierenden PSO nicht zuordnen kann.

Hinweise

Diese Funktion verwendet die Pipelinebeschreibung als D3D12_PIPELINE_STATE_STREAM_DESC und ersetzt die Funktionen ID3D12PipelineLibrary::LoadGraphicsPipeline und ID3D12PipelineLibrary::LoadComputePipeline , die ihre Pipelinebeschreibung als die weniger flexiblen 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 des Verhaltens einer Streamingpipeline desc finden Sie unter D3D12_PIPELINE_STATE_STREAM_DESC .

ID3D12PipelineLibrary1

Freigeben über