Share via


EffectPass.Begin Method

Begins a pass within the active technique.

Namespace: Microsoft.Xna.Framework.Graphics
Assembly: Microsoft.Xna.Framework (in microsoft.xna.framework.dll)

Syntax

public void Begin ()

Exceptions

Exception type Condition
InvalidOperationException

Begin has been called before calling End after the last call to Begin. Begin cannot be called again until End has been successfully called.

Remarks

An application sets one active pass (within one active technique) in the effect system by calling Begin. An application signals the end of the active pass by calling End. Begin and End must occur in a matching pair, within a matching pair of Effect.Begin and Effect.End calls.

If the application changes any effect state using any of the Effect methods inside of a Begin/End matching pair, the application must call CommitChanges to set the update the device with the state changes. If no state changes occur within a Begin and End matching pair, it is not necessary to call CommitChanges.

See Also

Tasks

How to: Create and Apply Custom Effects
How to: Use BasicEffect
How to: Create Custom Texture Effects

Reference

EffectPass Class
EffectPass Members
Microsoft.Xna.Framework.Graphics Namespace

Platforms

Xbox 360, Windows XP SP2, Windows Vista