D3DXCreateEffect fonction)

Créer un effet à partir d’une description d’effet ASCII ou binaire.

Syntaxe

HRESULT D3DXCreateEffect(
  _In_        LPDIRECT3DDEVICE9 pDevice,
  _In_        LPCVOID           pSrcData,
  _In_        UINT              SrcDataLen,
  _In_  const D3DXMACRO         *pDefines,
  _In_        LPD3DXINCLUDE     pInclude,
  _In_        DWORD             Flags,
  _In_        LPD3DXEFFECTPOOL  pPool,
  _Out_       LPD3DXEFFECT      *ppEffect,
  _Out_       LPD3DXBUFFER      *ppCompilationErrors
);

Paramètres

pDevice [ dans]

Type : LPDIRECT3DDEVICE9

Pointeur vers l’appareil qui va créer l’effet. Consultez IDirect3DDevice9.

pSrcData [ dans]

Type : LPCVOID

Pointeur vers une mémoire tampon qui contient une description d’effet.

SrcDataLen [ dans]

Type : uint

Longueur des données d’effet, en octets.

pDefines [ dans]

Type : const D3DXMACRO *

Tableau de structures D3DXMACRO se terminant par un caractère null facultatif qui décrivent les définitions de préprocesseur. 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.

Indicateurs [ dans]

Type : DWORD

Si pSrcData contient un effet de texte, Flags peut être une combinaison d' indicateurs D3DXSHADER et d’indicateurs D3DXFX ; Sinon, pSrcData contient un effet binaire et les seuls indicateurs honorés sont des indicateurs D3DXFX. Le compilateur HLSL Direct3D 10 est désormais la valeur par défaut. Pour plus d’informations , consultez outil de compilateur Effect .

pPool [ dans]

Type : LPD3DXEFFECTPOOL

Pointeur vers un objet ID3DXEffectPool à utiliser pour les paramètres partagés. Si cette valeur est null, aucun paramètre n’est partagé.

ppEffect [ à]

Type : LPD3DXEFFECT*

Retourne un pointeur vers une interface ID3DXEffect .

ppCompilationErrors [ à]

Type : LPD3DXBUFFER*

Retourne une mémoire tampon qui contient une liste d’erreurs de compilation.

Valeur de retour

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.

Spécifications

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

Voir aussi

Fonctions Effect

D3DXCompileShader

D3DXCompileShaderFromResource