Función D3DXCreateEffectFromResource

Cree un efecto a partir de una descripción de efecto ASCII o binario.

Sintaxis

HRESULT D3DXCreateEffectFromResource(
  _In_        LPDIRECT3DDEVICE9 pDevice,
  _In_        HMODULE           hSrcModule,
  _In_        LPCTSTR           pSrcResource,
  _In_  const D3DXMACRO         *pDefines,
  _In_        LPD3DXINCLUDE     pInclude,
  _In_        DWORD             Flags,
  _In_        LPD3DXEFFECTPOOL  pPool,
  _Out_       LPD3DXEFFECT      *ppEffect,
  _Out_       LPD3DXBUFFER      *ppCompilationErrors
);

Parámetros

pDevice [in]

Tipo: LPDIRECT3DDEVICE9

Puntero al dispositivo.

hSrcModule [in]

Tipo: HMODULE

Identificador de un módulo que contiene la descripción del efecto. Si este parámetro es NULL, se usará el módulo actual.

pSrcResource [in]

Tipo: LPCTSTR

Puntero al recurso. 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

Si hSrcModule contiene un efecto de texto, las marcas pueden ser una combinación de marcas D3DXSHADER y marcas D3DXFX ; de lo contrario, hSrcModule contiene un efecto binario y las únicas marcas que se respetan son marcas D3DXFX. 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.

pPool [in]

Tipo: LPD3DXEFFECTPOOL

Puntero a un objeto ID3DXEffectPool que se va a usar para parámetros compartidos. Si este valor es NULL, no se compartirá ningún parámetro.

ppEffect [out]

Tipo: LPD3DXEFFECT*

Devuelve un búfer que contiene el efecto compilado.

ppCompilationErrors [out]

Tipo: LPD3DXBUFFER*

Devuelve un búfer que contiene una lista de errores de compilación.

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, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Comentarios

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 D3DXCreateEffectFromResourceW. De lo contrario, la llamada de función se resuelve en D3DXCreateEffectFromResourceA porque se usan cadenas ANSI.

D3DXCreateEffectFromResource carga datos de un recurso de tipo RT_RCDATA. Consulte MSDN para obtener más información sobre los recursos de Windows.

Requisitos

Requisito	Value
Encabezado	D3DX9Effect.h
Biblioteca	D3dx9.lib

Consulte también

Funciones de efecto

D3DXCompileShader

D3DXCompileShaderFromResource