共用方式為


ID3DInclude::Open 方法 (d3dcommon.h)

用戶實作的方法,用於開啟和讀取著色器 #include 檔案的內容。

語法

HRESULT Open(
  D3D_INCLUDE_TYPE IncludeType,
  LPCSTR           pFileName,
  LPCVOID          pParentData,
  LPCVOID          *ppData,
  UINT             *pBytes
);

參數

IncludeType

類型: D3D_INCLUDE_TYPE

指出 #include 檔案位置的 D3D_INCLUDE_TYPE型別值。

pFileName

類型: LPCSTR

#include 檔的名稱。

pParentData

類型: LPCVOID

包含 #include 檔案之容器的指標。 編譯程式可能會在 pParentData 中傳遞 NULL。 For more information, see the "Searching for Include Files" section in Compile an Effect (Direct3D 11).

ppData

類型: LPCVOID*

包含 include 指示詞的緩衝區指標。 此指標會維持有效狀態,直到您呼叫ID3DInclude::Close為止。

pBytes

類型: UINT*

OpenppData 中傳回之位元組數目的指標。

傳回值

類型: HRESULT

用戶實作的方法必須傳回S_OK。 如果 Open 讀取 #include 檔案時失敗,則會導致 Open 呼叫失敗的應用程式開發介面 (API) 。 下列其中一種情況可能會發生此失敗:

  • 高階著色器語言 (HLSL) 著色器會失敗其中一個 D3D10CompileShader** 函式。
  • 效果會失敗其中一個 D3D10CreateEffect** 函式。

規格需求

需求
目標平台 Windows
標頭 d3dcommon.h
程式庫 D3DCompiler.lib
Dll D3DCompiler_47.dll

另請參閱

ID3DInclude

ID3DInclude::Close