Função D3DXPreprocessShaderFromFile

  • Artigo

Pré-processa um arquivo de sombreador sem executar a compilação. Isso resolve todos os #defines e #includes, fornecendo um sombreador autossuficiente para compilação subsequente.

Observação

Em vez de usar essa função herdada, recomendamos que você use a API D3DPreprocess .

 

Sintaxe

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

Parâmetros

pSrcFile [in]

Tipo: LPCSTR

Ponteiro para uma cadeia de caracteres que especifica o nome do arquivo do sombreador.

pDefines [in]

Tipo: const D3DXMACRO*

Uma matriz opcional terminada em NULL de estruturas D3DXMACRO . 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.

ppShaderText [out]

Tipo: LPD3DXBUFFER*

Retorna um buffer que contém uma única cadeia de caracteres grande que representa o fluxo de token formatado resultante.

ppErrorMsgs [out]

Tipo: LPD3DXBUFFER*

Retorna um buffer que contém uma listagem de erros e avisos que foram encontrados durante a compilação. Essas são as mesmas mensagens que o depurador exibe ao executar no modo de depuração. Esse valor pode ser NULL.

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

Requisitos

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

Confira também

Funções de sombreador

D3DXPreprocessShader

D3DXPreprocessShaderFromResource