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
);
參數
-
pDevice [in]
-
將建立效果之裝置的指標。 請參閱 IDirect3DDevice9。
-
pSrcData [in]
-
類型： LPCVOID
包含效果描述的緩衝區指標。
-
SrcDataLen [in]
-
類型： UINT
效果資料的長度，以位元組為單位。
-
pDefines [in]
-
類型：const D3DXMACRO*
描述預處理器定義的D3DXMACRO結構的選擇性Null終止陣列。 此值可以是 Null。
-
pInclude [in]
-
類型： LPD3DXINCLUDE
選擇性介面指標 ID3DXInclude，用於處理#include指示詞。 如果此值為 Null，則從檔案編譯時#includes會接受，或從資源或記憶體編譯時造成錯誤。
-
旗標 [in]
-
類型： DWORD
如果 pSrcData 包含文字效果，旗標可以是 D3DXSHADER 旗 標和 D3DXFX 旗標的組合;否則， pSrcData 包含二進位效果，唯一接受的旗標是 D3DXFX 旗標。 Direct3D 10 HLSL 編譯器現在是預設值。 如需詳細資訊，請參閱 Effect-Compiler Tool 。
-
pPool [in]
-
類型： LPD3DXEFFECTPOOL
要用於共用參數的 ID3DXEffectPool 物件的指標。 如果此值為 Null，則不會共用任何參數。
-
ppEffect [out]
-
類型： LPD3DXEFFECT*
傳回 ID3DXEffect 介面的指標。
-
ppCompilationErrors [out]
-
類型： LPD3DXBUFFER*
傳回包含編譯錯誤清單的緩衝區。
傳回值
類型： HRESULT
如果函式成功，傳回值會D3D_OK。 如果函式失敗，傳回值可以是下列其中一項：D3DERR_INVALIDCALL、D3DXERR_INVALIDDATA E_OUTOFMEMORY。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 |
|
| 程式庫 |
|
另請參閱