Skip to main content
Retrieves the requested PSO from the library. The input desc is matched against the data in the current library database, and remembered in order to prevent duplication of PSO contents.

​
Syntax

​
Parameters

pName [in]
Type: LPCWSTR The unique name of the PSO. pDesc [in]
Type: const D3D12_COMPUTE_PIPELINE_STATE_DESC * Specifies a description of the required PSO in a D3D12_COMPUTE_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: const IID & 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. ppPipelineState [out]
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

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

ID3D12PipelineLibrary
Last modified on August 20, 2026

Related topics

LoadPipelineCreatePipelineLibraryLoadGraphicsPipelineCreateComputePipelineStateD3D12_COMPUTE_PIPELINE_STATE_DESC