共用方式為


D3DX10CreateEffectFromFile 函式

從檔案建立效果。

語法

HRESULT D3DX10CreateEffectFromFile(
  _In_        LPCTSTR            pFileName,
  _In_  const D3D_SHADER_MACRO *pDefines,
  _In_        ID3D10Include      *pInclude,
  _In_        LPCSTR             pProfile,
  _In_        UINT               HLSLFlags,
  _In_        UINT               FXFlags,
  _In_        ID3D10Device       *pDevice,
  _In_        ID3D10EffectPool   *pEffectPool,
  _In_        ID3DX10ThreadPump  *pPump,
  _Out_       ID3D10Effect       **ppEffect,
  _Out_       ID3D10Blob         **ppErrors,
  _Out_       HRESULT            *pHResult
);

參數

pFileName [in]

類型: LPCTSTR

ASCII 效果檔案的名稱。 如果編譯器設定需要 Unicode,則資料類型 LPCTSTR 會解析為 LPCWSTR。 否則,資料類型會解析為 LPCSTR。

pDefines [in]

類型:const D3D_SHADER_MACRO*

著色器宏的 Null 終止陣列 (請參閱 D3D_SHADER_MACRO) ;將此設定為 Null ,以指定沒有宏。

pInclude [in]

類型: ID3D10Include*

包含介面的指標 (請參閱 ID3D10Include 介面) 。 此參數可以是 Null

pProfile [in]

類型: LPCSTR

指定 著色器設定檔或著色器模型的字串。

HLSLFlags [in]

類型: UINT

HLSL 編譯選項 (請參閱 D3D10_SHADER常數) 。

FXFlags [in]

類型: UINT

效果編譯選項 (請參閱 編譯和效果旗標) 。

pDevice [in]

類型: ID3D10Device*

裝置指標 (請參閱將使用資源的 ID3D10Device 介面) 。

pEffectPool [in]

類型: ID3D10EffectPool*

效果集區的指標 (請參閱 ID3D10EffectPool 介面) ,以在效果之間共用變數。

pPump [in]

類型: ID3DX10ThreadPump*

執行緒幫浦介面的指標 (請參閱 ID3DX10ThreadPump 介面) 。 使用 Null 指定此函式在完成之前不應傳回。

ppEffect [out]

類型: ID3D10Effect**

(效果指標的位址,請參閱所建立的 ID3D10Effect 介面) 。

ppErrors [out]

類型: ID3D10Blob**

記憶體指標的位址 (如果有任何,請參閱 ID3D10Blob 介面) ,其中包含效果編譯錯誤。

pHResult [out]

類型: HRESULT*

傳回值的指標。 可能是 Null。 如果 pPump 不是 Null,則 pHResult 必須是有效的記憶體位置,直到非同步執行完成為止。

傳回值

類型: HRESULT

傳回值是 Direct3D 10 傳回碼中列出的其中一個值。

規格需求

需求
標頭
D3DX10Async.h

另請參閱

常規用途函式