ID3DXEffect::CloneEffect method

Creates a copy of an effect.

Syntax

HRESULT CloneEffect(
  [in]  LPDIRECT3DDEVICE9 pDevice,
  [out] LPD3DXEFFECT      *ppEffect
);

Parameters

pDevice [in]

Type: LPDIRECT3DDEVICE9

Pointer to an IDirect3DDevice9 interface, representing the device associated with the effect.

ppEffect [out]

Type: LPD3DXEFFECT*

Pointer to an ID3DXEffect interface, containing the cloned effect.

Return value

Type: HRESULT

If the method succeeds, the return value is S_OK. If the method fails, the return value can be one of the following: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.

Remarks

Note

This function will not clone an effect if the user specifies D3DXFX_NOT_CLONEABLE during effect creation.

 

To update shared and non-shared parameters in an active technique of a cloned effect, see ID3DXEffect::CommitChanges.

Requirements

Requirement	Value
Header	D3DX9Effect.h
Library	D3dx9.lib

See also

ID3DXEffect