D3DXCreateEffectFromFile 函数

根据 ASCII 或二进制效果说明创建效果。

语法

HRESULT D3DXCreateEffectFromFile(
  _In_        LPDIRECT3DDEVICE9 pDevice,
  _In_        LPCTSTR           pSrcFile,
  _In_  const D3DXMACRO         *pDefines,
  _In_        LPD3DXINCLUDE     pInclude,
  _In_        DWORD             Flags,
  _In_        LPD3DXEFFECTPOOL  pPool,
  _Out_       LPD3DXEFFECT      *ppEffect,
  _Out_       LPD3DXBUFFER      *ppCompilationErrors
);

parameters

pDevice [in]

类型: LPDIRECT3DDEVICE9

指向将创建效果的设备的指针。 请参阅 IDirect3DDevice9

pSrcFile [in]

类型: LPCTSTR

指向文件名的指针。 此参数支持 Unicode 和 ANSI 字符串。 请参阅“备注”。

pDefines [in]

类型: const D3DXMACRO*

可选的以 NULL 结尾的预处理器宏定义数组。 请参阅 D3DXMACRO

pInclude [in]

类型: LPD3DXINCLUDE

可选接口指针 ID3DXInclude,用于处理#include指令。 如果此值为 NULL,则从文件编译时将遵循#includes,或者在从资源或内存编译时会导致错误。

Flags [in]

类型: DWORD

如果 pSrcFile 包含文本效果,标志可以是 D3DXSHADER 标志D3DXFX 标志的组合;否则, pSrcFile 包含二进制效果,并且唯一遵循的标志是 D3DXFX 标志。 Direct3D 10 HLSL 编译器现在是默认编译器。 有关详细信息 ,请参阅效果编译器工具

pPool [in]

类型: LPD3DXEFFECTPOOL

指向要用于共享参数的 ID3DXEffectPool 对象的指针。 如果此值为 NULL,则不会共享任何参数。

ppEffect [out]

类型: LPD3DXEFFECT*

返回指向包含编译效果的缓冲区的指针。 请参阅 ID3DXEffect

ppCompilationErrors [out]

类型: LPD3DXBUFFER*

返回指向包含编译错误列表的缓冲区的指针。 请参阅 ID3DXBuffer

返回值

类型: HRESULT

如果函数成功,则返回值D3D_OK。 如果函数失败,则返回值可以是下列值之一:D3DERR_INVALIDCALL、D3DXERR_INVALIDDATA、E_OUTOFMEMORY。

备注

如果编译器设置需要 Unicode,则数据类型 LPCTSTR 解析为 LPCWSTR。 否则,LPCTSTR 数据类型解析为 LPCSTR。

编译器设置还确定函数版本。 如果定义了 Unicode,则函数调用将解析为 D3DXCreateEffectFromFileW。 否则,函数调用将解析为 D3DXCreateEffectFromFileA,因为正在使用 ANSI 字符串。

要求

要求
标头
D3DX9Effect.h

D3dx9.lib

请参阅

效果函数

D3DXCompileShader

D3DXCompileShaderFromResource