Funzione D3DXAssembleShaderFromFile

Articolo
06/13/2023

Assemblare uno shader.

Sintassi

HRESULT D3DXAssembleShaderFromFile(
  _In_        LPCTSTR       pSrcFile,
  _In_  const D3DXMACRO     *pDefines,
  _In_        LPD3DXINCLUDE pInclude,
  _In_        DWORD         Flags,
  _Out_       LPD3DXBUFFER  *ppShader,
  _Out_       LPD3DXBUFFER  *ppErrorMsgs
);

Parametri

pSrcFile [in]

Tipo: LPCTSTR

Puntatore a una stringa che specifica il nome file. Se le impostazioni del compilatore richiedono Unicode, il tipo di dati LPCTSTR viene risolto in LPCWSTR. In caso contrario, il tipo di dati stringa viene risolto in LPCSTR. Vedere la sezione Osservazioni.

pDefines [in]

Tipo: const D3DXMACRO*

Matrice di terminazione NULL facoltativa delle strutture D3DXMACRO . Questo valore può essere NULL.

pInclude [in]

Tipo: LPD3DXINCLUDE

Puntatore di interfaccia facoltativo, ID3DXInclude, da usare per gestire le direttive di #include. Se questo valore è NULL, #includes verrà rispettato quando si compila da un file o si verificherà un errore quando viene compilato da una risorsa o da una memoria.

Flag [in]

Tipo: DWORD

Compilare le opzioni identificate da vari flag. Il compilatore Direct3D 10 HLSL è ora il valore predefinito. Per informazioni dettagliate, vedere Flag D3DXSHADER .

ppShader [out]

Tipo: LPD3DXBUFFER*

Restituisce un buffer contenente lo shader creato. Questo buffer contiene il codice shader compilato, nonché tutte le informazioni sulla tabella dei simboli e del debug incorporato.

ppErrorMsgs [out]

Tipo: LPD3DXBUFFER*

Restituisce un buffer contenente un elenco di errori e avvisi rilevati durante la compilazione. Questi sono gli stessi messaggi visualizzati dal debugger durante l'esecuzione in modalità di debug. Questo valore può essere NULL.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, il valore restituito è D3D_OK. Se la funzione ha esito negativo, il valore restituito può essere uno dei seguenti: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Commenti

L'impostazione del compilatore determina anche la versione della funzione. Se Unicode è definito, la chiamata alla funzione viene risolta in D3DXAssembleShaderFromFileW. In caso contrario, la chiamata alla funzione viene risolta in D3DXAssembleShaderFromFileA perché vengono usate stringhe ANSI.

Requisiti

Requisito	Valore
Intestazione	D3DX9Shader.h
Libreria	D3dx9.lib

Vedi anche

Funzioni shader
D3DXCompileShader
D3DXCompileShaderFromResource