D3DXAssembleShaderFromFile 函数

组装着色器。

语法

HRESULT D3DXAssembleShaderFromFile(
  _In_        LPCTSTR       pSrcFile,
  _In_  const D3DXMACRO     *pDefines,
  _In_        LPD3DXINCLUDE pInclude,
  _In_        DWORD         Flags,
  _Out_       LPD3DXBUFFER  *ppShader,
  _Out_       LPD3DXBUFFER  *ppErrorMsgs
);

参数

pSrcFile [in]

类型: LPCTSTR

指向指定文件名的字符串的指针。 如果编译器设置需要 Unicode,则数据类型 LPCTSTR 解析为 LPCWSTR。 否则,字符串数据类型解析为 LPCSTR。 请参阅“备注”。

pDefines [in]

类型: const D3DXMACRO*

D3DXMACRO 结构的可选 NULL 终止数组。 此值可以为 NULL

pInclude [in]

类型: LPD3DXINCLUDE

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

Flags [in]

类型: DWORD

由各种标志标识的编译选项。 Direct3D 10 HLSL 编译器现在是默认编译器。 有关详细信息,请参阅 D3DXSHADER 标志

ppShader [out]

类型: LPD3DXBUFFER*

返回包含创建的着色器的缓冲区。 此缓冲区包含已编译的着色器代码,以及任何嵌入的调试和符号表信息。

ppErrorMsgs [out]

类型: LPD3DXBUFFER*

返回一个缓冲区,其中包含编译过程中遇到的错误和警告的列表。 这些消息与调试器在调试模式下运行时显示的消息相同。 此值可以为 NULL

返回值

类型: HRESULT

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

备注

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

要求

要求
标头
D3DX9Shader.h

D3dx9.lib

另请参阅

着色器函数

D3DXCompileShader

D3DXCompileShaderFromResource