Plays an AVI clip in an animation control. The control plays the clip in the background while the thread continues executing. You can send this message explicitly or by using the Animate_Play macro.

Syntax

To send this message, call the SendMessage function as follows.

        lResult = SendMessage(     // returns LRESULT in lResult
        (HWND) hWndControl,        // handle to destination control
        (UINT) ACM_PLAY,           // message ID
        (WPARAM) wParam,           // = (WPARAM) (UINT) cRepeat
        (LPARAM) lParam            // = (LPARAM) MAKELONG(wFrom, wTo)
        );
    

Parameters

cRepeat

The number of times to replay the AVI clip. A value of -1 means replay the clip indefinitely.

wFrom

The zero-based index of the frame where playing begins. The value must be less than 65,536. A value of zero means begin with the first frame in the AVI clip.

wTo

The zero-based index of the frame where playing ends. The value must be less than 65,536. A value of -1 means end with the last frame in the AVI clip.

Return Value

Returns nonzero if successful, or zero otherwise.

Remarks

You can use Animate_Seek to direct the animation control to display a particular frame of the AVI clip.

Message Information

Header	commctrl.h
Minimum operating systems	Windows NT 3.51, Windows 95