Share via


ID3DXEffect::BeginPass, méthode

Commence une passe, dans la technique active.

Syntaxe

HRESULT BeginPass(
  [in] UINT Pass
);

Paramètres

Passer [in]

Type : UINT

Index entier de base zéro dans la technique.

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 passe active (au sein d’une technique active) dans le système d’effets en appelant ID3DXEffect::BeginPass. Une application signale la fin de la passe active en appelant ID3DXEffect::EndPass. ID3DXEffect::BeginPass et ID3DXEffect::EndPass doivent se produire dans une paire correspondante, dans une paire correspondante d’appels ID3DXEffect::Begin et ID3DXEffect::End .

Si l’application modifie un état d’effet à l’aide de l’une des méthodes Effect::Setx à l’intérieur d’une paire correspondante ID3DXEffect::BeginPass/ID3DXEffect::EndPass , l’application doit appeler ID3DXEffect::CommitChanges pour définir la mise à jour de l’appareil avec les changements d’état. Si aucune modification d’état ne se produit dans une paire correspondante ID3DXEffect::BeginPass et ID3DXEffect::EndPass , il n’est pas nécessaire d’appeler ID3DXEffect::CommitChanges.

Spécifications

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

Voir aussi

ID3DXEffect