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.
-
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.
Returns nonzero if successful, or zero otherwise.
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.
Requirement | Value |
---|---|
Minimum supported client |
Windows Vista [desktop apps only] |
Minimum supported server |
Windows Server 2003 [desktop apps only] |
Header |
|
Unicode and ANSI names |
ACM_OPENW (Unicode) and ACM_OPENA (ANSI) |