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]
-
裝置的指標。
-
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。
規格需求
需求 | 值 |
---|---|
標頭 |
|
程式庫 |
|
另請參閱