D3DX10CompileFromFile 関数

注意

このレガシ関数を使用する代わりに、Fxc.exe コマンドライン コンパイラを使用してオフラインでコンパイルするか 、D3DCompile API を使用することをお勧めします。

ファイルからシェーダーまたはエフェクトをコンパイルします。

構文

HRESULT D3DX10CompileFromFile(
  _In_        LPCTSTR            pSrcFile,
  _In_  const D3D_SHADER_MACRO *pDefines,
  _In_        LPD3D10INCLUDE     pInclude,
  _In_        LPCSTR             pFunctionName,
  _In_        LPCSTR             pProfile,
  _In_        UINT               Flags1,
  _In_        UINT               Flags2,
  _In_        ID3DX10ThreadPump  *pPump,
  _Out_       ID3D10Blob         **ppShader,
  _Out_       ID3D10Blob         **ppErrorMsgs,
  _Out_       HRESULT            *pHResult
);

パラメーター

pSrcFile [インチ]

種類: LPCTSTR

シェーダー コードを含むファイルの名前。 コンパイラ設定で Unicode が必要な場合、データ型 LPCTSTR は LPCWSTR に解決されます。 それ以外の場合、データ型は LPCSTR に解決されます。

pDefines [インチ]

種類: const D3D _ SHADER _ MACRO *

省略可能。 マクロ定義の配列へのポインター (「D3D _ SHADER _ MACRO」を参照)。 配列の最後の構造体はターミネータとして機能し、すべてのメンバーが 0 に設定されている必要があります。 使用しない場合は 、pDefines を NULL に 設定します

pInclude [インチ]

種類: LPD3D10INCLUDE

省略可能。 含まれるファイル を処理する ID3D10Include インターフェイス へのポインター。 これを NULL に 設定すると 、シェーダーに include が含まれている場合、コンパイル エラーが発生 # します。

pFunctionName [インチ]

種類: LPCSTR

シェーダーの実行が開始されるシェーダー エントリ ポイント関数の名前。 効果をコンパイルすると 、D3DX10CompileFromFilepFunctionName を無視しますpFunctionNameNULL に設定することをお勧めします。呼び出された関数で使用されない場合は、ポインター パラメーターを NULL に設定することをお勧めします。

pProfile [インチ]

種類: LPCSTR

シェーダー モデルを指定する文字列。には、シェーダー モデル 2、シェーダー モデル 3、または シェーダー モデル 4 の任意のプロファイルを指定できます

Flags1 [インチ]

種類: UINT

シェーダー コンパイル フラグ

Flags2 [インチ]

種類: UINT

効果コンパイル フラグ。 エフェクト ファイルではなくシェーダーをコンパイルすると 、D3DX10CompileFromFileFlags2 を無視します。Flags2 を0 に設定することをお勧めします。呼び出された関数で使用されない場合は、nonpointer パラメーターを 0 に設定することをお勧めします。

pPump [インチ]

種類: ID3DX10ThreadPump*

スレッド ポンプ インターフェイスへのポインター (「ID3DX10ThreadPump インターフェイス」を参照)。 NULL を使用 して、この関数が完了するまでこの関数を返す必要がなさいと指定します。

ppShader [乙]

種類: ID3D10Blob**

コンパイル済みシェーダーと、埋め込みデバッグおよびシンボル テーブル情報を含む ID3D10Blob インターフェイスへのポインター。

ppErrorMsgs [乙]

種類: ID3D10Blob**

コンパイル中に発生したエラーと警告の一覧を含む ID3D10Blob インターフェイスへのポインター。 これらのエラーと警告は、デバッガーからのデバッグ出力と同じです。

pHResult [乙]

種類: HRESULT*

戻り値へのポインター。 NULL を 指定できますpPump が NULL でない場合、非同期実行が完了するまで 、pHResult は有効なメモリの場所である必要があります。

戻り値

種類: HRESULT

戻り値は 、「Direct3D 10 リターン コード」に記載されている値の 1 つです

解説

必要条件

要件
ヘッダー
D3DX10Async.h

関連項目

General Purpose関数