ID3DXEffect::Begin, méthode
Démarre une technique active.
Syntaxe
HRESULT Begin(
[out] UINT *pPasses,
[in] DWORD Flags
);
Paramètres
-
pPasses [out]
-
Type : UINT*
Pointeur vers une valeur retournée qui indique le nombre de passes nécessaires pour afficher la technique actuelle.
-
Indicateurs [in]
-
Type : DWORD
DWORD qui détermine si l’état modifié par un effet est enregistré et restauré. La valeur par défaut 0 spécifie que ID3DXEffect::Begin et ID3DXEffect::End enregistrent et restaurent tous les états modifiés par l’effet (y compris les constantes de nuanceur de pixels et de vertex). Les indicateurs valides sont visibles dans Indicateurs d’enregistrement et de restauration de l’état d’effet.
Valeur retournée
Type : HRESULT
Si la méthode réussit, la valeur de retour est D3D_OK. Si la méthode échoue, la valeur de retour peut être l’une des suivantes : D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.
Notes
Une application définit une technique active dans le système d’effets en appelant ID3DXEffect::Begin. Le système d’effets répond en capturant tout l’état du pipeline qui peut être modifié par la technique dans un bloc d’état. Une application signale la fin d’une technique en appelant ID3DXEffect::End, qui utilise le bloc d’état pour restaurer l’état d’origine. Par conséquent, le système d’effets s’occupe de l’enregistrement de l’état lorsqu’une technique devient active et de la restauration de l’état à la fin d’une technique. Si vous choisissez de désactiver cette fonctionnalité d’enregistrement et de restauration, consultez D3DXFX_DONOTSAVESAMPLERSTATE.
Dans la paire ID3DXEffect::Begin et ID3DXEffect::End , une application utilise ID3DXEffect::BeginPass pour définir la passe active, ID3DXEffect::CommitChanges si des modifications d’état se sont produites après l’activation du passage, et ID3DXEffect::EndPass pour mettre fin à la passe active.
Spécifications
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|
Voir aussi