D3DXCreateEffectFromResource fonction)
Créer un effet à partir d’une description d’effet ASCII ou binaire.
Syntaxe
HRESULT D3DXCreateEffectFromResource(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ HMODULE hSrcModule,
_In_ LPCTSTR pSrcResource,
_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.
-
hSrcModule [ dans]
-
Type : HMODULE
Handle d’un module contenant la description de l’effet. Si ce paramètre a la valeur null, le module actuel est utilisé.
-
pSrcResource [ dans]
-
Type : LPCTSTR
Pointeur vers la ressource. Ce paramètre prend en charge les chaînes Unicode et ANSI. Consultez la section Notes.
-
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 hSrcModule contient un effet de texte, Flags peut être une combinaison d' indicateurs D3DXSHADER et d’indicateurs D3DXFX ; Sinon, hSrcModule 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 une mémoire tampon contenant l’effet compilé.
-
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.
Notes
Si les paramètres du compilateur requièrent Unicode, le type de données LPCTSTR est résolu en LPCWSTR. Dans le cas contraire, 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 D3DXCreateEffectFromResourceW. Dans le cas contraire, l’appel de fonction est résolu en D3DXCreateEffectFromResourceA, car les chaînes ANSI sont utilisées.
D3DXCreateEffectFromResource charge des données à partir d’une ressource de type RT _ RCDATA. pour plus d’informations sur les ressources de Windows, consultez MSDN.
Spécifications
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|