Partager via


Fonction D3DXCreateEffectCompilerFromFile

Crée un compilateur d’effets à partir d’une description d’effet ASCII.

Syntaxe

HRESULT D3DXCreateEffectCompilerFromFile(
  _In_        LPCTSTR              pSrcFile,
  _In_  const D3DXMACRO            *pDefines,
  _In_        LPD3DXINCLUDE        pInclude,
  _In_        DWORD                Flags,
  _Out_       LPD3DXEFFECTCOMPILER *ppEffectCompiler,
  _Out_       LPD3DXBUFFER         *ppParseErrors
);

Paramètres

pSrcFile [in]

Type : LPCTSTR

Pointeur vers le nom de fichier. Ce paramètre prend en charge les chaînes Unicode et ANSI. Consultez la section Notes.

pDefines [in]

Type : const D3DXMACRO*

Tableau facultatif terminé par null de structures D3DXMACRO qui décrivent des définitions de préprocesseur. 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.

Indicateurs [in]

Type : DWORD

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

ppEffectCompiler [out]

Type : LPD3DXEFFECTCOMPILER*

Adresse d’un pointeur vers une interface ID3DXEffectCompiler , contenant le compilateur d’effets.

ppParseErrors [out]

Type : LPD3DXBUFFER*

Adresse d’un pointeur vers une interface ID3DXBuffer , contenant les messages d’erreur qui se sont produits pendant la compilation. Ce paramètre peut être défini sur NULL pour ignorer les messages d’erreur.

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, E_OUTOFMEMORY.

Notes

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 LPCTSTR est résolu en LPCSTR.

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 D3DXCreateEffectCompilerFromFileW. Sinon, l’appel de fonction est résolu en D3DXCreateEffectCompilerFromFileA, car les chaînes ANSI sont utilisées.

Spécifications

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

Voir aussi

Fonctions d’effet

D3DXCreateEffectCompiler

D3DXCreateEffectCompilerFromResource