D3DXPreprocessShaderFromFile fonction)

Prétraite un fichier de nuanceur sans effectuer la compilation. Cela résout tous les # définitions et les # inclusions, en fournissant un nuanceur autonome pour la compilation suivante.

Notes

Au lieu d’utiliser cette fonction héritée, nous vous recommandons d’utiliser l’API D3DPreprocess .

Syntaxe

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

Paramètres

pSrcFile [ dans]

Type : LPCSTR

Pointeur vers une chaîne qui spécifie le nom de fichier du nuanceur.

pDefines [ dans]

Type : const D3DXMACRO *

Tableau de structures D3DXMACRO terminé par un caractère null facultatif. Cette valeur peut être null.

pInclude [ dans]

Type : LPD3DXINCLUDE

Pointeur d’interface facultatif, ID3DXInclude, à utiliser pour gérer les # directives include. Si cette valeur est null, # include est respecté lors de la compilation à partir d’un fichier ou provoque une erreur lorsqu’elle est compilée à partir d’une ressource ou d’une mémoire.

ppShaderText [ à]

Type : LPD3DXBUFFER*

Retourne une mémoire tampon contenant une seule grande chaîne qui représente le flux de jetons mis en forme résultant.

ppErrorMsgs [ à]

Type : LPD3DXBUFFER*

Retourne une mémoire tampon qui contient une liste d’erreurs et d’avertissements qui ont été rencontrés pendant la compilation. Ce sont les mêmes messages que le débogueur affiche lorsqu’il s’exécute en mode débogage. Cette valeur peut être null.

Valeur retournée

Type : HRESULT

Si la fonction est réussie, la valeur de retour est D3D _ OK. Si la fonction échoue, la valeur de retour peut être l’une des suivantes : D3DERR _ INVALIDCALL, D3DXERR _ sera déplacé, E _ OUTOFMEMORY.

Configuration requise

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

Voir aussi

Fonctions de nuanceur

D3DXPreprocessShader

D3DXPreprocessShaderFromResource