D3DXCreateEffect 函数
根据 ASCII 或二进制效果说明创建效果。
语法
HRESULT D3DXCreateEffect(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ LPCVOID pSrcData,
_In_ UINT SrcDataLen,
_In_ const D3DXMACRO *pDefines,
_In_ LPD3DXINCLUDE pInclude,
_In_ DWORD Flags,
_In_ LPD3DXEFFECTPOOL pPool,
_Out_ LPD3DXEFFECT *ppEffect,
_Out_ LPD3DXBUFFER *ppCompilationErrors
);
parameters
-
pDevice [in]
-
指向将创建效果的设备的指针。 请参阅 IDirect3DDevice9。
-
pSrcData [in]
-
类型: LPCVOID
指向包含效果说明的缓冲区的指针。
-
SrcDataLen [in]
-
类型: UINT
效果数据的长度(以字节为单位)。
-
pDefines [in]
-
类型: const D3DXMACRO*
可选的 以 NULL 结尾的 D3DXMACRO 结构数组,用于描述预处理器定义。 此值可以为 NULL。
-
pInclude [in]
-
类型: LPD3DXINCLUDE
可选接口指针 ID3DXInclude,用于处理#include指令。 如果此值为 NULL,则从文件编译时将遵循#includes,或者在从资源或内存编译时会导致错误。
-
Flags [in]
-
类型: DWORD
如果 pSrcData 包含文本效果,标志可以是 D3DXSHADER 标志 和 D3DXFX 标志的组合;否则, pSrcData 包含二进制效果,并且只接受 D3DXFX 标志。 Direct3D 10 HLSL 编译器现在是默认编译器。 有关详细信息 ,请参阅效果编译器工具 。
-
pPool [in]
-
类型: LPD3DXEFFECTPOOL
指向要用于共享参数的 ID3DXEffectPool 对象的指针。 如果此值为 NULL,则不会共享任何参数。
-
ppEffect [out]
-
类型: LPD3DXEFFECT*
返回指向 ID3DXEffect 接口的指针。
-
ppCompilationErrors [out]
-
类型: LPD3DXBUFFER*
返回包含编译错误列表的缓冲区。
返回值
类型: HRESULT
如果函数成功,则返回值D3D_OK。 如果函数失败,则返回值可以是下列值之一:D3DERR_INVALIDCALL、D3DXERR_INVALIDDATA、E_OUTOFMEMORY。
要求
要求 | 值 |
---|---|
标头 |
|
库 |
|
请参阅