Método ID3DXInclude::Open

Um método implementado pelo usuário para abrir e ler o conteúdo de um sombreador #include arquivo.

Sintaxe

HRESULT Open(
  [in]  D3DXINCLUDE_TYPE IncludeType,
  [in]  LPCSTR           pFileName,
  [in]  LPCVOID          pParentData,
  [out] LPCVOID          *ppData,
  [out] UINT             *pBytes
);

Parâmetros

IncludeType [in]

Tipo: D3DXINCLUDE_TYPE

O local do arquivo #include. Confira D3DXINCLUDE_TYPE.

pFileName [in]

Tipo: LPCSTR

Nome do arquivo #include.

pParentData [in]

Tipo: LPCVOID

Ponteiro para o contêiner que inclui o arquivo #include. O compilador pode passar NULL em pParentData. Para obter mais informações, consulte a seção "Procurando arquivos de inclusão" em Compilar um efeito (Direct3D 11).

ppData [out]

Tipo: LPCVOID*

Ponteiro para o buffer retornado que contém as diretivas include. Esse ponteiro permanece válido até que ID3DXInclude::Close seja chamado.

pBytes [out]

Tipo: UINT*

Número de bytes retornados em ppData.

Valor retornado

Tipo: HRESULT

O método implementado pelo usuário deve retornar S_OK. Se o retorno de chamada falhar ao ler o arquivo #include, a API que fez com que o retorno de chamada fosse chamado falhará. Ele é um dos seguintes:

  • O sombreador HLSL falhará em uma das funções D3DXCompileShader***.
  • O sombreador de assembly falhará em uma das funções D3DXAssembleShader***.
  • O efeito falhará em uma das funções D3DXCreateEffect*** ou D3DXCreateEffectCompiler***.

Requisitos

Requisito Valor
parâmetro
D3DX9Shader.h
Biblioteca
D3dx9.lib

Confira também

ID3DXInclude

ID3DXInclude::Close