共用方式為


D3DXCreateEffectFromResource 函式

從 ASCII 或二進位效果描述建立效果。

語法

HRESULT D3DXCreateEffectFromResource(
  _In_        LPDIRECT3DDEVICE9 pDevice,
  _In_        HMODULE           hSrcModule,
  _In_        LPCTSTR           pSrcResource,
  _In_  const D3DXMACRO         *pDefines,
  _In_        LPD3DXINCLUDE     pInclude,
  _In_        DWORD             Flags,
  _In_        LPD3DXEFFECTPOOL  pPool,
  _Out_       LPD3DXEFFECT      *ppEffect,
  _Out_       LPD3DXBUFFER      *ppCompilationErrors
);

參數

pDevice [in]

類型: LPDIRECT3DDEVICE9

裝置的指標。

hSrcModule [in]

類型: HMODULE

包含效果描述的模組控制碼。 如果此參數為 Null,則會使用目前的模組。

pSrcResource [in]

類型: LPCTSTR

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

pDefines [in]

類型:const D3DXMACRO*

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

pInclude [in]

類型: LPD3DXINCLUDE

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

旗標 [in]

類型: DWORD

如果 hSrcModule 包含文字效果,旗標可以是 D3DXSHADER 旗 標和 D3DXFX 旗標的組合;否則, hSrcModule 包含二進位效果,唯一接受的旗標是 D3DXFX 旗標。 Direct3D 10 HLSL 編譯器現在是預設值。 如需詳細資訊,請參閱 Effect-Compiler Tool

pPool [in]

類型: LPD3DXEFFECTPOOL

要用於共用參數的 ID3DXEffectPool 物件的指標。 如果此值為 Null,則不會共用任何參數。

ppEffect [out]

類型: LPD3DXEFFECT*

傳回包含已編譯效果的緩衝區。

ppCompilationErrors [out]

類型: LPD3DXBUFFER*

傳回緩衝區,其中包含編譯錯誤的清單。

傳回值

類型: HRESULT

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

備註

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

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

D3DXCreateEffectFromResource 會從類型為 RT_RCDATA 的資源載入資料。 如需 Windows 資源的詳細資訊,請參閱 MSDN。

規格需求

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

另請參閱

效果函式

D3DXCompileShader

D3DXCompileShaderFromResource