Fonction D3DXAssembleShaderFromFile

Assemblez un nuanceur.

Syntaxe

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

Paramètres

pSrcFile [in]

Type : LPCTSTR

Pointeur vers une chaîne qui spécifie le nom de fichier. Si les paramètres du compilateur nécessitent Unicode, le type de données LPCTSTR est résolu en LPCWSTR. Sinon, le type de données de chaîne est résolu en LPCSTR. Consultez la section Notes.

pDefines [in]

Type : const D3DXMACRO*

Tableau null facultatif de structures D3DXMACRO . Cette valeur peut être NULL.

pInclude [in]

Type : LPD3DXINCLUDE

Pointeur d’interface facultatif, ID3DXInclude, à utiliser pour gérer les directives #include. Si cette valeur a la valeur NULL, #includes sera respecté lors de la compilation à partir d’un fichier ou provoquera une erreur lors de la compilation à partir d’une ressource ou d’une mémoire.

Indicateurs [in]

Type : DWORD

Options de compilation identifiées par différents indicateurs. Le compilateur HLSL Direct3D 10 est désormais la valeur par défaut. Pour plus d’informations, consultez Indicateurs D3DXSHADER .

ppShader [out]

Type : LPD3DXBUFFER*

Retourne une mémoire tampon contenant le nuanceur créé. Cette mémoire tampon contient le code de nuanceur compilé, ainsi que toutes les informations de débogage et de table de symboles incorporées.

ppErrorMsgs [out]

Type : LPD3DXBUFFER*

Retourne une mémoire tampon contenant une liste des erreurs et des avertissements rencontrés lors de la compilation. Il s’agit des mêmes messages affichés par le débogueur lors de l’exécution en mode débogage. Cette valeur peut être NULL.

Valeur retournée

Type : HRESULT

Si la fonction réussit, la valeur de retour est D3D_OK. Si la fonction échoue, la valeur de retour peut être l’une des suivantes : D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Notes

Le paramètre du compilateur détermine également la version de la fonction. Si Unicode est défini, l’appel de fonction est résolu en D3DXAssembleShaderFromFileW. Sinon, l’appel de fonction est résolu en D3DXAssembleShaderFromFileA, car les chaînes ANSI sont utilisées.

Spécifications

Condition requise	Valeur
En-tête	D3DX9Shader.h
Bibliothèque	D3dx9.lib

Voir aussi

Fonctions de nuanceur

D3DXCompileShader

D3DXCompileShaderFromResource