Compartilhar via


Função D3DXCreateEffectCompilerFromFile

Cria um compilador de efeito com base em uma descrição de efeito ASCII.

Sintaxe

HRESULT D3DXCreateEffectCompilerFromFile(
  _In_        LPCTSTR              pSrcFile,
  _In_  const D3DXMACRO            *pDefines,
  _In_        LPD3DXINCLUDE        pInclude,
  _In_        DWORD                Flags,
  _Out_       LPD3DXEFFECTCOMPILER *ppEffectCompiler,
  _Out_       LPD3DXBUFFER         *ppParseErrors
);

Parâmetros

pSrcFile [in]

Tipo: LPCTSTR

Ponteiro para o nome do arquivo. Esse parâmetro dá suporte a cadeias de caracteres Unicode e ANSI. Consulte Observações.

pDefines [in]

Tipo: const D3DXMACRO*

Uma matriz opcional terminada em NULL de estruturas D3DXMACRO que descrevem definições de pré-processador. Esse valor pode ser NULL.

pInclude [in]

Tipo: LPD3DXINCLUDE

Ponteiro de interface opcional, ID3DXInclude, a ser usado para lidar com diretivas de #include. Se esse valor for NULL, #includes será respeitado ao compilar de um arquivo ou causará um erro quando compilado de um recurso ou memória.

Sinalizadores [in]

Tipo: DWORD

Compile opções identificadas por vários sinalizadores (consulte Sinalizadores D3DXSHADER). O compilador HLSL do Direct3D 10 agora é o padrão. Consulte Effect-Compiler Tool para obter detalhes.

ppEffectCompiler [out]

Tipo: LPD3DXEFFECTCOMPILER*

Endereço de um ponteiro para uma interface ID3DXEffectCompiler , que contém o compilador de efeito.

ppParseErrors [out]

Tipo: LPD3DXBUFFER*

Endereço de um ponteiro para uma interface ID3DXBuffer , contendo mensagens de erro que ocorreram durante a compilação. Esse parâmetro pode ser definido como NULL para ignorar mensagens de erro.

Valor retornado

Tipo: HRESULT

Se a função for bem-sucedida, o valor retornado será D3D_OK. Se a função falhar, o valor retornado poderá ser um dos seguintes: D3DERR_INVALIDCALL, E_OUTOFMEMORY.

Comentários

Se as configurações do compilador exigirem Unicode, o tipo de dados LPCTSTR será resolvido para LPCWSTR. Caso contrário, o tipo de dados LPCTSTR será resolvido para LPCSTR.

A configuração do compilador também determina a versão da função. Se Unicode for definido, a chamada de função será resolvida para D3DXCreateEffectCompilerFromFileW. Caso contrário, a chamada de função será resolvida para D3DXCreateEffectCompilerFromFileA porque cadeias de caracteres ANSI estão sendo usadas.

Requisitos

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

Confira também

Funções de efeito

D3DXCreateEffectCompiler

D3DXCreateEffectCompilerFromResource