Skip to main content
Retrieves the requested PSO from the library.

Syntax

Parameters

pName [in]
Type: LPCWSTR
The unique name of the PSO. pDesc [in]
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: 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