D3DXPreprocessShaderFromFile, fonction
Prétraite un fichier de nuanceur sans effectuer de compilation. Cela résout tous les #defines et #includes, 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 [in]
-
Type : LPCSTR
Pointeur vers une chaîne qui spécifie le nom de fichier du nuanceur.
-
pDefines [in]
-
Type : const D3DXMACRO*
Tableau facultatif de structures D3DXMACRO terminées par null. Cette valeur peut être NULL.
-
pInclude [in]
-
Type : LPD3DXINCLUDE
Pointeur d’interface facultatif, ID3DXInclude, à utiliser pour la gestion des directives #include. Si cette valeur est 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 grande chaîne qui représente le flux de jetons mis en forme résultant.
-
ppErrorMsgs [out]
-
Type : LPD3DXBUFFER*
Retourne une mémoire tampon contenant une liste d’erreurs et d’avertissements rencontrés pendant la compilation. Il s’agit des mêmes messages que le débogueur affiche 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.
Spécifications
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|
Voir aussi