D3DXPreprocessShaderFromResource fonction)

Prétraite une ressource 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 D3DXPreprocessShaderFromResource(
  _In_        HMODULE       hSrcModule,
  _In_        LPCSTR        pSrcResource,
  _In_  const D3DXMACRO     *pDefines,
  _In_        LPD3DXINCLUDE pInclude,
  _Out_       LPD3DXBUFFER  *ppShaderText,
  _Out_       LPD3DXBUFFER  *ppErrorMsgs
);

Paramètres

hSrcModule [ dans]

Type : HMODULE

Handle du module qui contient la ressource de nuanceur. Si cette valeur est null, le module en cours sera utilisé.

pSrcResource [ dans]

Type : LPCSTR

Chaîne qui représente le nom de la ressource dans le module.

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 renvoyé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

D3DXPreprocessShaderFromFile

D3DXPreprocessShader