D3DXCreateEffect

Create an effect from an ASCII or binary effect description.

HRESULT D3DXCreateEffect(
  LPDIRECT3DDEVICE9 pDevice,
  LPCVOID pSrcData,
  UINT SrcDataLen,
  CONST D3DXMACRO * pDefines,
  LPD3DXINCLUDE pInclude,
  DWORD Flags,
  LPD3DXEFFECTPOOL pPool,
  LPD3DXEFFECT * ppEffect,
  LPD3DXBUFFER * ppCompilationErrors
);

Parameters

pDevice

[in] Pointer to the device that will create the effect. See IDirect3DDevice9.

pSrcData

[in] Pointer to a buffer containing an effect description.

SrcDataLen

[in] Length of the effect data, in bytes.

pDefines

[in] Pointer to the preprocessor definitions. See D3DXMACRO.

pInclude

[in] Optional interface pointer, ID3DXInclude, to use for handling #include directives. If this value is NULL, #includes will either be honored when compiling from a file or will cause an error when compiled from a resource or memory.

Flags

[in] If pSrcData contains a text effect, flags can be a combination of D3DXSHADER Flags and D3DXFX flags; otherwise, pSrcData contains a binary effect and the only flags honored are D3DXFX flags.

pPool

[in] Pointer to a ID3DXEffectPool object to use for shared parameters. If this value is NULL, no parameters will be shared.

ppEffect

[out] Returns a pointer to an ID3DXEffect interface.

ppCompilationErrors

[out] Returns a buffer containing a listing of compile errors.

Return Values

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

Requirements

Header: Declared in D3dx9effect.h.

See Also

D3DXCompileShader, D3DXCompileShaderFromResource