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	D3DX9Effect.h
Bibliothèque	D3dx9.lib

Voir aussi

ID3DXEffect