共用方式為


D3DXCreateEffectCompilerFromFile 函式

從 ASCII 效果描述建立效果編譯器。

語法

HRESULT D3DXCreateEffectCompilerFromFile(
  _In_        LPCTSTR              pSrcFile,
  _In_  const D3DXMACRO            *pDefines,
  _In_        LPD3DXINCLUDE        pInclude,
  _In_        DWORD                Flags,
  _Out_       LPD3DXEFFECTCOMPILER *ppEffectCompiler,
  _Out_       LPD3DXBUFFER         *ppParseErrors
);

參數

pSrcFile [in]

類型: LPCTSTR

檔案名的指標。 此參數同時支援 Unicode 和 ANSI 字串。 請參閱<備註>。

pDefines [in]

類型:const D3DXMACRO*

描述預處理器定義的D3DXMACRO結構的選擇性Null終止陣列。 此值可以是 Null

pInclude [in]

類型: LPD3DXINCLUDE

選擇性介面指標 ID3DXInclude,用於處理#include指示詞。 如果此值為 Null,則從檔案編譯時,#includes將會接受,或從資源或記憶體編譯時造成錯誤。

旗標 [in]

類型: DWORD

(各種旗標所識別的編譯選項,請參閱 D3DXSHADER 旗標) 。 Direct3D 10 HLSL 編譯器現在是預設值。 如需詳細資訊,請參閱 Effect-Compiler Tool

ppEffectCompiler [out]

類型: LPD3DXEFFECTCOMPILER*

ID3DXEffectCompiler介面指標的位址,其中包含效果編譯器。

ppParseErrors [out]

類型: LPD3DXBUFFER*

ID3DXBuffer介面指標的位址,其中包含編譯期間發生的任何錯誤訊息。 此參數可以設定為 Null ,以忽略錯誤訊息。

傳回值

類型: HRESULT

如果函式成功,傳回值會D3D_OK。 如果函式失敗,傳回值可以是下列其中一項:D3DERR_INVALIDCALL,E_OUTOFMEMORY。

備註

如果編譯器設定需要 Unicode,則資料類型 LPCTSTR 會解析為 LPCWSTR。 否則,LPCTSTR 資料類型會解析為 LPCSTR。

編譯器設定也會決定函式版本。 如果已定義 Unicode,函式呼叫會解析為 D3DXCreateEffectCompilerFromFileW。 否則,函式呼叫會解析為 D3DXCreateEffectCompilerFromFileA,因為正在使用 ANSI 字串。

規格需求

需求
標頭
D3DX9Effect.h
程式庫
D3dx9.lib

另請參閱

效果函式

D3DXCreateEffectCompiler

D3DXCreateEffectCompilerFromResource