Función D3DXCreateEffectCompilerFromFile

Artículo
06/13/2023

Crea un compilador de efectos a partir de una descripción del efecto ASCII.

Sintaxis

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

Puntero al nombre de archivo. Este parámetro admite cadenas Unicode y ANSI. Vea la sección Comentarios.

pDefines [in]

Tipo: const D3DXMACRO*

Matriz opcional terminada en NULL de estructuras D3DXMACRO que describen definiciones de preprocesador. Este valor puede ser NULL.

pInclude [in]

Tipo: LPD3DXINCLUDE

Puntero de interfaz opcional, ID3DXInclude, que se usará para controlar directivas #include. Si este valor es NULL, se respetará #includes al compilar desde un archivo o provocará un error cuando se compile desde un recurso o memoria.

Marcas [in]

Tipo: DWORD

Compile las opciones identificadas por varias marcas (vea D3DXSHADER Flags). El compilador HLSL de Direct3D 10 ahora es el predeterminado. Consulte Effect-Compiler Tool (Herramienta del compilador de efectos ) para obtener más información.

ppEffectCompiler [out]

Tipo: LPD3DXEFFECTCOMPILER*

Dirección de un puntero a una interfaz ID3DXEffectCompiler que contiene el compilador de efectos.

ppParseErrors [out]

Tipo: LPD3DXBUFFER*

Dirección de un puntero a una interfaz ID3DXBuffer , que contiene los mensajes de error que se produjeron durante la compilación. Este parámetro se puede establecer en NULL para omitir los mensajes de error.

Valor devuelto

Tipo: HRESULT

Si la función se ejecuta correctamente, el valor devuelto es D3D_OK. Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes: D3DERR_INVALIDCALL, E_OUTOFMEMORY.

Observaciones

Si la configuración del compilador requiere Unicode, el tipo de datos LPCTSTR se resuelve en LPCWSTR. De lo contrario, el tipo de datos LPCTSTR se resuelve en LPCSTR.

La configuración del compilador también determina la versión de la función. Si se define Unicode, la llamada de función se resuelve en D3DXCreateEffectCompilerFromFileW. De lo contrario, la llamada de función se resuelve en D3DXCreateEffectCompilerFromFileA porque se usan cadenas ANSI.

Requisitos

Requisito	Value
Encabezado	D3DX9Effect.h
Biblioteca	D3dx9.lib

Vea también

Funciones de efecto
D3DXCreateEffectCompiler
D3DXCreateEffectCompilerFromResource