D3DX10CompileFromFile 関数

[アーティクル]
06/12/2023

注意

このレガシ関数を使用する代わりに、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 [in]

種類: LPCTSTR

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

pDefines [in]

型: const D3D_SHADER_MACRO*

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

pInclude [in]

種類: LPD3D10INCLUDE

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

pFunctionName [in]

種類: LPCSTR

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

pProfile [in]

種類: LPCSTR

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

Flags1 [in]

型: UINT

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

Flags2 [in]

型: UINT

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

pPump [in]