ID3D12PipelineLibrary::LoadGraphicsPipeline method (d3d12.h)

Retrieves the requested PSO from the library.

Syntax

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

Parameters

[in] pName

Type: LPCWSTR

The unique name of the PSO.

[in] pDesc

Type: const D3D12_GRAPHICS_PIPELINE_STATE_DESC*

Specifies a description of the required PSO in a D3D12_GRAPHICS_PIPELINE_STATE_DESC structure. This input description is matched against the data in the current library database, and stored in order to prevent duplication of PSO contents.

riid

Type: REFIID

Specifies a REFIID for the ID3D12PipelineState object. Typically set this, and the following parameter, with the macro IID_PPV_ARGS(&PSO1), where PSO1 is the name of the object.

[out] ppPipelineState

Type: void**

Specifies a pointer that will reference the returned PSO.

Return value

Type: HRESULT

This method returns an HRESULT success or error code, which can include E_INVALIDARG if the name doesn’t exist, or if the input description doesn’t match the data in the library, and E_OUTOFMEMORY if unable to allocate the return PSO.

Remarks

Refer to the remarks and examples for CreatePipelineLibrary.

Requirements

Requirement Value
Target Platform Windows
Header d3d12.h
Library D3d12.lib
DLL D3d12.dll

See also

ID3D12PipelineLibrary