ID3D12Device::CreateDerivedComputePipelineStateX Method

Efficiently creates a compute pipeline state object that’s derived from another pipeline state object.

Syntax

public:
HRESULT D3DAPI CreateDerivedComputePipelineStateX(
         ID3D12PipelineState *pSrcPipelineState,
         UINT NumDescs,
         const D3D12XBOX_DERIVED_COMPUTE_STATE_DESC *pDescs,
         REFIID riid,
         void **ppDerivedPipelineState
)  

Parameters

pSrcPipelineState
Type: ID3D12PipelineState *

[in] A pointer to the source pipeline state.

NumDescs
Type: UINT 

[in] The number of derived compute state descriptions in pDescs.

pDescs
Type: D3D12XBOX_DERIVED_COMPUTE_STATE_DESC *

[in] A pointer to an array of derived compute state descriptions.

riid
Type: REFIID 

[in] The globally unique identifier (GUID) for the pipeline state interface (ID3D12PipelineState. The REFIID, or GUID, of the interface to the pipeline state can be obtained by using the __uuidof() macro.

ppDerivedPipelineState
Type: void **

[out] The resulting derived compute pipeline state object.

Return value

Type: HRESULT D3DAPI 

One of the Direct3D 12 return codes.

Remarks

This method provides an efficient means of creating a graphics Pipeline State object that is derived from another Pipeline State object. The new derived object is created using the source object’s state as the base state while allowing shader limits to be changed. Any state not overridden will be set to the same values as the source Pipeline State object.

Caller responsibilities:

• If the source pipeline state object was created with ID3D12Device::DeserializeComputePilelineStateX, its the caller’s responsibility to ensure that the GPU instructions persist for the lifetime of both the source and derived pipeline state object.
• If the source pipeline state object was created with ID3D12Device::CreateComputePipelineStateX, D3D12.x automatically adds a reference count to the source object to ensure that its GPU instructions persist for the lifetime of the derived pipeline state object.

Requirements

Header: Declared in d3d12_x.h.

Library: Use d3d12_x.lib.