Función D3DXPreprocessShader

Artículo
06/13/2023

Preprocesa un 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 D3DXPreprocessShader(
  _In_        LPCSTR        pSrcData,
  _In_        UINT          SrcDataSize,
  _In_  const D3DXMACRO     *pDefines,
  _In_        LPD3DXINCLUDE pInclude,
  _Out_       LPD3DXBUFFER  *ppShaderText,
  _Out_       LPD3DXBUFFER  *ppErrorMsgs
);

Parámetros

pSrcData [in]

Tipo: LPCSTR

Puntero a una cadena que contiene el sombreador.

SrcDataSize [in]

Tipo: UINT

Longitud de los datos en bytes.

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 #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.

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 cuando se ejecuta en modo de depuración. Este valor puede ser NULL.

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.

Requisitos

Requisito	Value
Encabezado	D3DX9Shader.h
Biblioteca	D3dx9.lib

Consulte también

Funciones del sombreador
D3DXPreprocessShaderFromFile
D3DXPreprocessShaderFromResource