D3DXCreateEffectFromResource 関数
D3DXCreateEffectFromResource 関数
エフェクトの ASCII 記述またはバイナリ記述からエフェクトを作成する。
構文
HRESULT D3DXCreateEffectFromResource(
LPDIRECT3DDEVICE9 pDevice,
HMODULE hSrcModule,
LPCSTR pSrcResource,
CONST D3DXMACRO* pDefines,
LPD3DXINCLUDE pInclude,
DWORD Flags,
LPD3DXEFFECTPOOL pPool,
LPD3DXBUFFER* ppEffect,
LPD3DXBUFFER *ppCompilationErrors
);
パラメータ
- pDevice
[in] デバイスへのポインタ。 - hSrcModule
[in] エフェクトの記述を含むモジュールのハンドル。この引数に NULL を指定すると、現在のモジュールが使用される。 - pSrcResource
[in] リソースへのポインタ。この引数は、Unicode 文字列と ANSI 文字列の両方をサポートしている。「注意」を参照すること。 - pDefines
[in] プリプロセッサ定義へのポインタ。「D3DXMACRO」を参照すること。 - pInclude
[in] オプションのインターフェイス ポインタ ID3DXInclude。#include 擬似命令の処理に使う。この値に NULL を指定すると、#includes はファイルからコンパイルする場合は有効だが、リソースやメモリからコンパイルする場合はエラーとなる。 - Flags
[in] D3DXSHADER で識別されるコンパイル オプション。 - pPool
[in] 共有引数で使う ID3DXEffectPool オブジェクトへのポインタ。この値に NULL を指定すると、引数は共有されない。 - ppEffect
[out] コンパイルされたエフェクトが格納されたバッファを返す。 - ppCompilationErrors
[out] コンパイル エラーの一覧が格納されたバッファを返す。
戻り値
成功した場合は、D3D_OK を返す。
失敗した場合は、次のいずれかの値を返す。
D3DERR_INVALIDCALL | メソッドの呼び出しが無効である。たとえば、メソッドの引数に無効な値が設定されている場合などである。 |
D3DXERR_INVALIDDATA | データが無効である。 |
E_OUTOFMEMORY | Microsoft® Direct3D® が呼び出しを完了するための十分なメモリを割り当てることができなかった。 |
注意
コンパイラ設定によって、関数のバージョンも決まる。Unicode を定義すると、関数呼び出しは D3DXCreateEffectFromResourceW に解決される。それ以外の場合、ANSI 文字列が使われているので、関数呼び出しは D3DXCreateEffectFromResourceA に解決される。
D3DXCreateEffectFromResource は、RT_RCDATA 型のリソースからデータをロードする。Windows のリソースの詳細については、MSDN を参照すること。
関数の情報
ヘッダー | d3dx9effect.h |
インポート ライブラリ | d3dx9.lib |
最低限のオペレーティング システム | Windows 98 |
参照