ID3DXFragmentLinker::LinkPixelShader

Link a compiled pixel shader at run time. This is a very lightweight operation.

HRESULT LinkPixelShader(
  LPCSTR pProfile,
  DWORD Flags,
  CONST D3DXHANDLE * rgFragmentHandles,
  UINT cFragments,
  LPDIRECT3DPIXELSHADER9 * pPShader,
  LPD3DXBUFFER * ppErrorMsgs
);

Parameters

pProfile

[in] Pointer to a pixel shader profile which detemines the shader instruction set. See D3DXGetPixelShaderProfile for a list of the profiles available.

Flags

[in] Link options. See D3DXSHADER Flags.

rgFragmentHandles

[in] An array of pixel shader fragment handles. See Handles.

cFragments

[in] Number of fragments to be linked.

pPShader

[out] Pointer to a pixel shader. See IDirect3DPixelShader9.

ppErrorMsgs

[out, retval] Buffer containing at least the first compile error message that occurred. This includes effect compiler errors and high-level language compile errors. For more information about accessing the buffer, see ID3DXBuffer.

Return Values

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

Requirements

Header: Declared in D3dx9shader.h.