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*

Open 在 ppData 中傳回之位元組數目的指標。

傳回值

類型： HRESULT

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

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

規格需求

另請參閱

ID3DInclude

ID3DInclude：：Close