Función D3DXPreprocessShaderFromFile

Preprocesa un archivo de sombreador sin realizar la compilación. Esto resuelve todos los #defines y #includes, lo que proporciona un sombreador independiente para la compilación posterior.

Nota

En lugar de usar esta función heredada, se recomienda usar la API D3DPreprocess .

 

Sintaxis

HRESULT D3DXPreprocessShaderFromFile(
  _In_        LPCSTR        pSrcFile,
  _In_  const D3DXMACRO     *pDefines,
  _In_        LPD3DXINCLUDE pInclude,
  _Out_       LPD3DXBUFFER  *ppShaderText,
  _Out_       LPD3DXBUFFER  *ppErrorMsgs
);

Parámetros

pSrcFile [in]

Tipo: LPCSTR

Puntero a una cadena que especifica el nombre de archivo del sombreador.

pDefines [in]

Tipo: const D3DXMACRO*

Matriz opcional terminada en NULL de estructuras D3DXMACRO . Este valor puede ser NULL.

pInclude [in]

Tipo: LPD3DXINCLUDE

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

ppShaderText [out]

Tipo: LPD3DXBUFFER*

Devuelve un búfer que contiene una sola cadena grande que representa la secuencia de tokens con formato resultante.

ppErrorMsgs [out]

Tipo: LPD3DXBUFFER*

Devuelve un búfer que contiene una lista de errores y advertencias que se encontraron durante la compilación. Estos son los mismos mensajes que muestra el depurador al ejecutarse en modo de depuración. Este valor puede ser NULL.

Valor devuelto

Tipo: HRESULT

Si la función se realiza correctamente, el valor devuelto se 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.

Requisitos

Requisito	Value
Encabezado	D3DX9Shader.h
Biblioteca	D3dx9.lib

Vea también

Funciones del sombreador

D3DXPreprocessShader

D3DXPreprocessShaderFromResource