Skip to main content
Retrieves the requested PSO from the library. The pipeline stream description is matched against the library database and remembered in order to prevent duplication of PSO contents.

Syntax

Parameters

pName [in]
Type: LPCWSTR
SAL: In The unique name of the PSO. pDesc [in]
Type: const D3D12_PIPELINE_STATE_STREAM_DESC *
SAL: In Describes the required PSO using a D3D12_PIPELINE_STATE_STREAM_DESC structure. This description is matched against the library database and stored in order to prevent duplication of PSO contents. riid
Type: const IID &
Specifies a REFIID for the ID3D12PipelineStateState object. Applications should typically set this argument and the following argument, ppPipelineState, by using the macro IID_PPV_ARGS(&PSO1), where PSO1 is the name of the object. ppPipelineState [out]
Type: void **
SAL: COM_Outptr Specifies the pointer that will reference the PSO after the function successfully returns.

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 the stream description doesn’t match the data in the library, and E_OUTOFMEMORY if the function is unable to allocate the resulting PSO.

Remarks

This function takes the pipeline description as a D3D12_PIPELINE_STATE_STREAM_DESC and is a replacement for the ID3D12PipelineLibrary::LoadGraphicsPipeline and ID3D12PipelineLibrary::LoadComputePipeline functions, which take their pipeline description as the less-flexible D3D12_GRAPHICS_PIPELINE_STATE_DESC and D3D12_COMPUTE_PIPELINE_STATE_DESC structs, respectively.

Requirements

Header: d3d12_xs.h or d3d12_x.h
Library: d3d12_xs.lib or d3d12_x.lib
Supported Platforms: XBOX Series consoles and XBOX One family

See Also

See D3D12_PIPELINE_STATE_STREAM_DESC for a description of the layout and behavior of a streaming pipeline desc. ID3D12PipelineLibrary1
Last modified on August 20, 2026