ACM_OPEN (Shell and User Interface) (Windows Embedded CE 6.0)

1/6/2010

This 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.

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

Syntax

lResult = SendMessage(
   (HWND) hWndControl,
   (UINT) ACM_OPEN,
   wParam = (WPARAM) (HINSTANCE) hinst,
   lParam = (LPARAM) (LPSTR) lpszName
);

Parameters

• hinst
  Instance handle to the module from which the resource should be loaded. To have the control use the HINSTANCE value used to create the window, set this value to NULL. Note that if the window is created by a DLL, the default value for hinst is the HINSTANCE value of the DLL, not of the application that calls the DLL.

  Setting this value to NULL is not an option when lpszName is used as the AVI resource identifier.

• lpszName
  Pointer to a buffer that contains the path of the AVI file. The AVI file specified by lpszName must not contain audio.

  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 specified by lpszName must not contain audio.

You can only open silent AVI clips. ACM_OPEN (Shell and User Interface) and Animate_Open fail if lpszName specifies an AVI clip that contains sound.

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

ACM_OPEN will not work if the user passes a null handle as a parameter to the resources instance of the process that creates a given window control. This is because retrieving the handle to that instance is not supported on Windows Embedded CE.

Requirements

See Also

Reference

Animation Controls Messages