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

#include ディレクティブの処理に使用するオプションのインターフェイス ポインター ID3DXInclude。 この値が NULL の場合、#includesはファイルからコンパイルするときに優先されるか、リソースまたはメモリからコンパイルされるときにエラーが発生します。

Flags [in]

種類: DWORD

hSrcModule にテキスト効果が含まれている場合、フラグは D3DXSHADER フラグと D3DXFX フラグの組み合わせにすることができます。それ以外の場合、hSrcModule にはバイナリ効果が含まれており、指定されるフラグは D3DXFX フラグのみです。 Direct3D 10 HLSL コンパイラが既定になりました。 詳細については、「 エフェクト コンパイラ ツール 」を参照してください。

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 に解決されます。 それ以外の場合、ANSI 文字列が使用されているため、関数呼び出しは D3DXCreateEffectFromResourceA に解決されます。

D3DXCreateEffectFromResource は、RT_RCDATA型のリソースからデータを読み込みます。 Windows リソースの詳細については、MSDN を参照してください。

要件

要件 値
ヘッダー
D3DX9Effect.h
ライブラリ
D3dx9.lib

こちらもご覧ください

効果関数

D3DXCompileShader

D3DXCompileShaderFromResource