Partager via


Fonction D3DXPreprocessShader

Prétraite un nuanceur sans effectuer de compilation. Cela résout tous les #defines et #includes, ce qui fournit 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 D3DXPreprocessShader(
  _In_        LPCSTR        pSrcData,
  _In_        UINT          SrcDataSize,
  _In_  const D3DXMACRO     *pDefines,
  _In_        LPD3DXINCLUDE pInclude,
  _Out_       LPD3DXBUFFER  *ppShaderText,
  _Out_       LPD3DXBUFFER  *ppErrorMsgs
);

Paramètres

pSrcData [in]

Type : LPCSTR

Pointeur vers une chaîne qui contient le nuanceur.

SrcDataSize [in]

Type : UINT

Longueur des données en octets.

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.

ppShaderText [out]

Type : LPD3DXBUFFER*

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

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.

Configuration requise

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

Voir aussi

Fonctions de nuanceur

D3DXPreprocessShaderFromFile

D3DXPreprocessShaderFromResource