D3D10CompileShader 函式 (d3d10shader.h)

編譯 HLSL 著色器。

注意 請使用 D3DX10CompileFromMemory ，而不是此函式。

 

語法

HRESULT D3D10CompileShader(
  [in]  LPCSTR                   pSrcData,
  [in]  SIZE_T                   SrcDataSize,
  [in]  LPCSTR                   pFileName,
  [in]  const D3D10_SHADER_MACRO *pDefines,
  [in]  LPD3D10INCLUDE           pInclude,
  [in]  LPCSTR                   pFunctionName,
  [in]  LPCSTR                   pProfile,
  [in]  UINT                     Flags,
  [out] ID3D10Blob               **ppShader,
  [out] ID3D10Blob               **ppErrorMsgs
);

參數

[in] pSrcData

類型： LPCSTR

包含著色器原始程式碼的字串指標。

[in] SrcDataSize

類型： SIZE_T

pSrcData 的大小，以位元組為單位。

[in] pFileName

類型： LPCSTR

包含著色器程式代碼的檔名。

[in] pDefines

類型： const D3D10_SHADER_MACRO*

選擇性。 宏定義的陣列指標 (請參閱 D3D10_SHADER_MACRO) 。 陣列中的最後一個結構會做為終止符，而且所有成員都必須設定為 0。
如果未使用，請將 pDefines 設定為 NULL。

[in] pInclude

類型： LPD3D10INCLUDE*

選擇性。 ID3D10Include Interface 介面的指標，用於處理 include 檔案。 如果著色器包含 #include，將此設定為 NULL 會導致編譯錯誤。

[in] pFunctionName

類型： LPCSTR

著色器執行開始處的著色器進入點函式名稱。

[in] pProfile

類型： LPCSTR

指定 著色器配置檔 或著色器模型的字串。

[in] Flags

類型： UINT

著色器 編譯選項。

[out] ppShader

類型： ID3D10Blob**

ID3D10Blob 介面的指標，其中包含已編譯的著色器，以及任何內嵌的偵錯和符號數據表資訊。

[out] ppErrorMsgs

類型： ID3D10Blob**

ID3D10Blob 介面的指標，其中包含編譯期間發生的錯誤和警告清單。 這些錯誤和警告與調試程式的偵錯輸出相同。

傳回值

類型： HRESULT

傳回下列其中一個 Direct3D 10 傳回碼。

備註

此函式會使用 2006 年 11 月 DirectX SDK 中發行的 HLSL 編譯程式版本。

此函式會實作兩種方式來提供輸入著色器資訊。 請使用 pSrcData 和 SrcDataLen 來指定包含著色器 HLSL 程式代碼的字串 (，並將 pFileName 設定為 NULL) ，或使用 pFileName 指定著色器或效果檔案的名稱 (並將 pSrcData 設定為 NULL) 。

若要設定可程式化管線階段，請編譯著色器，然後將著色器系結至適當的管線階段。 例如，以下是編譯幾何著色器的範例 (請參閱 編譯幾何著色器) 。

此函式 D3D10CompileShader 會呼叫每次操作系統發行時隨附的著色器編譯程式版本。 DirectX SDK 隨附時，著色器編譯程式的最新版本會隨附，其可藉由呼叫 D3DX10CompileFromFile 之類的著色器編譯程序進入點函式版本從 D3DX 存取。 最好使用 D3DX 進入點函式，以確保如果您要轉散發 DirectX 可轉散發連結庫，則會使用最新版本的著色器編譯程式。

規格需求

需求	值
目標平台	Windows
標頭	d3d10shader.h
程式庫	D3D10.lib
Dll	D3D10.dll

另請參閱

著色器函式