Compartilhar via


Método ID3DInclude::Open (d3dcommon.h)

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

Sintaxe

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

Parâmetros

IncludeType

Tipo: D3D_INCLUDE_TYPE

Um valor de tipo D3D_INCLUDE_TYPE que indica o local do arquivo #include.

pFileName

Tipo: LPCSTR

Nome do arquivo #include.

pParentData

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

Tipo: LPCVOID*

Ponteiro para o buffer que contém as diretivas include. Esse ponteiro permanece válido até que você chameID3DInclude::Close.

pBytes

Tipo: UINT*

Ponteiro para o número de bytes que Open retorna em ppData.

Retornar valor

Tipo: HRESULT

O método implementado pelo usuário deve retornar S_OK. Se Open falhar ao ler o arquivo #include, a API (interface de programação do aplicativo) que fez com que Open fosse chamado falhará. Essa falha pode ocorrer em uma das seguintes situações:

  • O sombreador HLSL (linguagem de sombreador de alto nível) falha em uma das funções D3D10CompileShader*** .
  • O efeito falha em uma das funções D3D10CreateEffect*** .

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho d3dcommon.h
Biblioteca D3DCompiler.lib
DLL D3DCompiler_47.dll

Confira também

ID3DInclude

ID3DInclude::Close