Fonction D3DXCreateEffectFromFileEx
Créez un effet à partir d’une description d’effet ASCII ou binaire. Cette fonction est une version étendue de D3DXCreateEffectFromFile qui permet à une application de contrôler les paramètres ignorés par le système d’effets.
Syntaxe
HRESULT D3DXCreateEffectFromFileEx(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ LPCTSTR pSrcFile,
_In_ const D3DXMACRO *pDefines,
_In_ LPD3DXINCLUDE pInclude,
_In_ LPCSTR pSkipConstants,
_In_ DWORD Flags,
_In_ LPD3DXEFFECTPOOL pPool,
_Out_ LPD3DXEFFECT *ppEffect,
_Out_ LPD3DXBUFFER *ppCompilationErrors
);
Paramètres
-
pDevice [in]
-
Type : LPDIRECT3DDEVICE9
Pointeur vers l’appareil qui créera l’effet. Consultez IDirect3DDevice9.
-
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 null facultatif de définitions de macros de préprocesseur. Consultez D3DXMACRO.
-
pInclude [in]
-
Type : LPD3DXINCLUDE
Pointeur d’interface facultatif, ID3DXInclude, à utiliser pour gérer les directives #include. Si cette valeur a la valeur 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.
-
pSkipConstants [in]
-
Type : LPCSTR
Chaîne de paramètres d’effet qui seront ignorés par le système d’effet. La chaîne doit être terminée par null et doit contenir le nom de chaque constante gérée par l’application séparée par un point-virgule.
-
Indicateurs [in]
-
Type : DWORD
Si pSrcFile contient un effet de texte, les indicateurs peuvent être une combinaison d’indicateurs D3DXSHADER et d’indicateurs D3DXFX ; sinon, pSrcFile contient un effet binaire et les seuls indicateurs respectés sont des indicateurs D3DXFX. Le compilateur HLSL Direct3D 10 est désormais la valeur par défaut. Pour plus d’informations, consultez Effect-Compiler Tool .
-
pPool [in]
-
Type : LPD3DXEFFECTPOOL
Pointeur vers un objet ID3DXEffectPool à utiliser pour les paramètres partagés. Si cette valeur a la valeur NULL, aucun paramètre n’est partagé.
-
ppEffect [out]
-
Type : LPD3DXEFFECT*
Retourne un pointeur vers une mémoire tampon contenant l’effet compilé. Consultez ID3DXEffect.
-
ppCompilationErrors [out]
-
Type : LPD3DXBUFFER*
Retourne un pointeur vers une mémoire tampon contenant une liste des erreurs de compilation. Consultez ID3DXBuffer.
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.
Notes
Cette fonction est une version étendue de D3DXCreateEffectFromFile qui permet à une application de spécifier les constantes d’effet qui seront gérées par l’application. Une constante gérée par l’application est ignorée par le système d’effets. Autrement dit, l’application est responsable de l’initialisation de la constante, ainsi que de l’enregistrement et de la restauration de son état chaque fois que cela est approprié.
Cette fonction vérifie chaque constante dans pSkipConstants pour voir que :
- Il est lié à un registre constant.
- Il est utilisé uniquement dans le code de nuanceur HLSL.
Si une constante est nommée dans la chaîne qui n’est pas présente dans l’effet, elle est ignorée.
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 D3DXCreateEffectFromFileW. Sinon, l’appel de fonction est résolu en D3DXCreateEffectFromFileA, car les chaînes ANSI sont utilisées.
Spécifications
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|
Voir aussi