Edit

Share via


ACM_OPEN message

Opens an AVI clip and displays its first frame in an animation control. You can send this message explicitly or use the Animate_Open or Animate_OpenEx macro. We recommend using the Unicode version of this message, ACM_OPENW.

Parameters

wParam

Version 4.71 and later. An instance handle to the module from which the resource should be loaded. Set this value to NULL to have the control use the HINSTANCE value used to create the window. Note that if the window is created by a DLL, the default value for wParam is the HINSTANCE value of the DLL, not of the application that calls the DLL.

lParam

A pointer to a buffer that contains the path of the AVI file or the name of an AVI resource. Alternatively, this parameter can consist of the AVI resource identifier in the LOWORD and zero in the HIWORD. To create this value, use the MAKEINTRESOURCE macro. The control loads the AVI resource from the module specified by the instance handle passed to the CreateWindow function, the Animate_Create macro, or the dialog box creation function that created the control. In Version 4.71 and later, the resource is loaded from the module specified by wParam. An AVI resource must have the "AVI" type. If this parameter is NULL, the system closes the AVI file that was previously opened for the specified animation control, if any.

Return value

Returns nonzero if successful, or zero otherwise.

Remarks

The AVI file or resource specified by lpszName must not contain audio.

We recommend using the Unicode version of this message, ACM_OPENW.

You can only open silent AVI clips. ACM_OPEN and Animate_Open fail if lParam specifies an AVI clip that contains sound.

You can use Animate_Close to close an AVI file or AVI resource that was previously opened for the specified animation control.

Requirements

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
Commctrl.h
Unicode and ANSI names
ACM_OPENW (Unicode) and ACM_OPENA (ANSI)