Source code of Windows XP (NT5)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 

2578 lines
88 KiB

/*
modified July 23, 1993 HFF Marked messages used in macros as internal.
These messages are documented with equivalent
macro.
*/
/*----------------------------------------------------------------------------*\
*
* MCIWnd
*
* the MCIWnd window class is a window class for controling MCI devices
* MCI devices include, wave files, midi files, AVI Video, cd audio,
* vcr, video disc, and others..
*
* to learn more about MCI and mci command sets see the
* "Microsoft Multimedia Programmers's guide" in the Win31 SDK
*
* the easiest use of the MCIWnd class is like so:
*
* hwnd = MCIWndCreate(hwndParent, hInstance, 0, "smag.wav");
* ...
* MCIWndPlay(hwnd);
* MCIWndStop(hwnd);
* MCIWndPause(hwnd);
* ....
* MCIWndDestroy(hwnd);
*
* this will create a window with a play/pause, stop and a playbar
* and start the wave file playing.
*
* mciwnd.h defines macros for all the most common MCI commands, but
* any string command can be used if needed. Note unlike the
* mciSendString() API, no alias or file name needs to be specifed.
*
* MCIWndSendString(hwnd, "set hue to bright");
*
*
*----------------------------------------------------------------------------*/
/***********************************************************************
* @doc EXTERNAL
*
* @api BOOL | MCIWndRegisterClass | This function registers the MCI
* window class MCIWND_WINDOW_CLASS.
*
* @parm HINSTANCE | hinstance | Specifies a handle to the device instance.
*
* @rdesc Returns zero if the class is registered successfully.
*
* @comm Use <f CreateWindow> to create the window used for
* playing the MCI device. Use <f MCIWndCreate> to
* simultaneously register the window class and
* create a window.
*
* @xref MCIWndCreate
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api HWND | MCIWndCreate | This function creates an MCIWnd window for
* using MCI services.
*
* @parm HWND | hwndParent | Specifies a handle to the parent window.
*
* @parm HINSTANCE | hInstance | Specifies the window instance.
*
* @parm DWORD | dwStyle | Specifies any flags for the window style.
* If you do not specify any of the WS_ styles, your window will
* use WS_CHILD, WS_BORDER, and WS_VISIBLE if you specify a non-NULL
* parent window, and WS_OVERLAPPEDWINDOW and WS_VISIBLE otherwise.
* Thus, to create an invisible child window, specify WS_CHILD to
* prevent the default flags from being used.
*
* The following styles are defined in addition to
* those defined for <f CreateWindow>.
*
* @flag MCIWNDF_NOAUTOSIZEWINDOW | Inhibits the changing of
* the window size when the image size changes. By default,
* the window size changes automatically to reflect changes in
* image size. The window also automatically resizes when a
* new file opens or closes.
*
* @flag MCIWNDF_NOAUTOSIZEMOVIE | Prevents stretching the
* image when window size changes. For MCI devices
* that display video in a window, MCIWnd normally
* resizes the image to fill the window.
*
* @flag MCIWNDF_NOPLAYBAR | Inhibits the display of the playbar.
* By default, a playbar is displayed. The default controls on
* on the playbar include the PLAY, STOP, RECORD,
* and MENU buttons as well as a trackbar to set the
* media position.
*
* Holding a shift key down while pressing the PLAY button plays
* the media backwards (if supported). For windowed devices,
* holding the control key down while pressing the PLAY
* button plays the device in FULLSCREEN mode if supported.
*
* @flag MCIWNDF_NOMENU | Inhibits the display of a menu button
* on the playbar and inhibits display of the popup menu
* normally available when the right mouse button
* is pressed when the cursor is over the window.
*
* @flag MCIWNDF_RECORD | Displays a record button on the playbar
* or menu, and adds a new file command to the menu.
* By default, only nondestructive
* commands are available on the playbar and menu.
*
* @flag MCIWNDF_NOERRORDLG | Inhibits display of an error dialog
* box for MCI errors. Applications can use <f MCIWndGetError>
* to determine the most recent error.
*
* @flag MCIWNDF_NOTIFYMODE | Has MCIWnd notify the parent
* window when the mode of the MCI device changes.
* Whenever the mode changes (for example,
* from stop to play) the parent window receives a
* <m MCIWNDM_NOTIFYMODE> message. The <p lParam> of the
* message contains the new state of the device (for
* example, MCI_MODE_STOP). The application can get
* the text string of the new mode with the <f MCIWndGetMode>.
*
* @flag MCIWNDF_NOTIFYPOS | Has MCIWnd notify the parent window
* when the position of the media changes. MCIWnd sends
* the <m MCIWNDM_NOTIFYPOS> message to inform the parent
* window of changes. The <p lParam> of the message
* contains the new position in the media.
*
* @flag MCIWNDF_NOTIFYMEDIA | Has MCIWnd notify the parent window
* when the media changes. Whenever a file is opened or
* closed, or a new device is loaded, MCIWnd sends the
* <m MCIWNDM_NOTIFYMEDIA> message. The <p lParam> of
* the message contains a pointer to the new filename.
*
* @flag MCIWNDF_NOTIFYSIZE | Has MCIWnd notify the parent window
* when the size of the window changes.
*
* @flag MCIWNDF_NOTIFYERROR | Has MCIWnd notify the parent window
* when an error occurs.
*
* @flag MCIWNDF_NOTIFYALL | Notifies parent window of all changes.
*
* @flag MCIWNDF_SHOWNAME | Displays the name of the open
* MCI device element in the window caption.
*
* @flag MCIWNDF_SHOWPOS | Displays the position of the MCI device
* in the window caption.
*
* @flag MCIWNDF_SHOWMODE | Displays the mode of the MCI device
* in the window caption.
*
* @flag MCIWNDF_SHOWALL | Displays all window features.
*
* @parm LPSTR | szFile | Specifies a zero-terminated string indicating
* the name of an MCI device or device element to open.
*
* @rdesc Returns a handle to an MCIWnd window if successful.
* Otherwise it returns zero.
*
* @comm Use the window handle returned by this function for the
* window handle in the MCIWnd macros. If your application
* uses this macro, it does not need to use <f MCIWndRegisterClass>.
*
* For non-windowed devices, applications need a window to
* display the toolbar and trackbar. Applications that
* access non-windowed devices (such as a waveform audio device),
* and do not display any controls, can leave the window invisible.
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_???? | This message is a placeholder for
* flags until I find out which message they apply to.
*
* @parm LPARAM | wFlags | Specifies applicable flags for the open.
*
*
* @flag MCIWND_START | Indicates the start of the media.
*
* @flag MCIWND_END | Indicates the end of the media.
*
* @flag MCIWND_CURRENT | Indicates the current position.
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_SENDSTRING | This MCIWnd message sends a string command
* to an MCI device.
*
* @parm WPARAM | WParam1 | Not used; set to zero.
*
* @parm LPARAM | lParam | Specifies a zero-terminated string to
* send to the MCI device.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm When sending a string with this message, omit the
* alias used when a string is sent with <f mciSendString>.
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_GETPOSITION | This MCIWnd message has an MCI
* device return the current position of the device element.
*
* @parm WPARAM | wParam | Not used; set to zero.
*
* @parm LPARAM | lParam | Not used; set to zero.
*
* @rdesc Returns the current position.
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_GETSTART | This MCIWnd message has an MCI
* device return the starting position of the device element.
*
* @parm WPARAM | wParam | Not used; set to zero.
*
* @parm LPARAM | lParam | Not used; set to zero.
*
* @rdesc Returns the starting position of the device element.
*
* @comm Typically the return value is zero but some devices
* use a non-zero starting position for the device
* element.
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_GETLENGTH | This MCIWnd message has an MCI
* device return the length of its media.
*
* @parm WPARAM | wParam | Not used; set to zero.
*
* @parm LPARAM | lParam | Not used; set to zero.
*
* @rdesc Returns the length of the media.
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_GETEND | This MCIWnd message has an MCI
* device return the ending position of the media.
* (The ending position corresponds to the starting
* position plus the length.)
*
* @parm WPARAM | wParam | Not used; set to zero.
*
* @parm LPARAM | lParam | Not used; set to zero.
*
* @rdesc Returns the ending position of the media.
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_GETMODE | This MCIWnd message has an MCI
* device return its mode.
*
* @parm WPARAM | wParam | Specifies the size of the data buffer.
*
* @parm LPARAM | lParam | Specifies a far pointer to the
* application-supplied buffer used to return the mode.
*
* @rdesc Returns an integer corresponding to the MCI mode.
*
* @comm If the zero-terminated string describing the mode is
* longer than the buffer, it is truncated.
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_SETZOOM | This MCIWnd message has an MCI device stretch
* a video image.
*
* @parm WPARAM | wParam | Not used; set to zero.
*
* @parm LPARAM | lParam | Specifies an integer indicating
* the zoom factor as a percentage of the original
* image. Specifying 100 displays the image at its
* authored sized. Specifying 200 displays the image
* at twice normal size. Specifying 50 displays the image at
* half normal size.
*
* @rdesc None.
*
* @xref MCIWNDM_GETZOOM
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_GETZOOM | This MCIWnd message has an MCI device return
* the zoom factor last set with <f MCIWNDM_SETZOOM>.
*
* @parm WPARAM | wParam | Not used; set to zero.
*
* @parm LPARAM | lParam | Not used; set to zero.
*
* @rdesc Returns an integer corresponding to the zoom factor. A value
* of 100 indicates the image is not zoomed. A value of 200
* indicates the image is twice normal size. A value of 50
* indicates the image is half normal size.
*
* @xref MCIWNDM_SETZOOM
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_EJECT | This MCIWnd message has an MCI
* device eject its media.
*
* @parm WPARAM | wParam | Not used; set to zero.
*
* @parm LPARAM | lParam | Not used; set to zero.
*
* @rdesc Returns false if successful. Otherwise it returns
* an MCI error code.
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_SETVOLUME | This MCIWnd message has an MCI
* device set its volume level.
*
* @parm WPARAM | wParam | Not used; set to zero.
*
* @parm LPARAM | lParam | Specifies an integer indicating the volume level
* Specify 1000 for the normal volume level. Specify larger
* values to increase the volume level and smaller
* values to decrease the volume level.
*
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @xref MCIWNDM_GETVOLUME
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_GETVOLUME | This MCIWnd message has an MCI
* device return its volume level.
*
* @parm WPARAM | wParam | Not used; set to zero.
*
* @parm LPARAM | lParam | Not used; set to zero.
*
* @rdesc Returns the volume level.
*
* @xref MCIWNDM_SETVOLUME
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_SETSPEED | This MCIWnd message has an MCI
* device set its playback speed.
*
* @parm WPARAM | wParam | Not used; set to zero.
*
* @parm LPARAM | lParam | Specifies an integer indicating
* the playback speed. Specify 1000
* for the normal speed. Specify larger values for faster speeds
* and smaller values for slower speeds.
**
* @rdesc Returns false if successful. Otherwise it returns
* an MCI error code.
*
* @xref MCIWNDM_GETSPEED
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_GETSPEED | This MCIWnd message has an MCI
* device return its playback speed.
*
* @parm WPARAM | wParam | Not used; set to zero.
*
* @parm LPARAM | lParam | Not used; set to zero.
*
* @rdesc Returns the playback speed.
*
* @xref MCIWNDM_SetSpeed
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_SETTIMEFORMAT | This MCIWnd message has an MCI
* device set its time format.
*
* @parm WPARAM | wParam | Not used; set to zero.
*
* @parm LPARAM | lParam | Specifies a far pointer to a data buffer
* containing the time format.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm Application can specify formats other than frames and
* milliseconds if they are supported by the MCI device.
* Non-continuous formats, such as tracks and
* SMPTE can cause the scroll bar to behave erratically.
* For these time formats, applications might change the
* window style by using MCIWNDF_NOPLAYBAR to turn off the
* playbar.
*
* @xref MCIWNDM_GETTIMEFORMAT
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_GETTIMEFORMAT | This MCIWnd message has an MCI
* device return its time format.
*
* @parm WPARAM | wParam | Specifies the size of the data buffer.
*
* @parm LPARAM | lParam | Specifies a far pointer to the
* application-supplied data buffer used to return the time format.
*
* @rdesc Returns an integer corresponding to the MCI time format.
*
* @comm If the zero-terminated string describing the time format
* longer than the buffer, MCIWnd truncates it.
*
* @xref MCIWNDM_SETTIMEFORMAT
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_PLAYFROM | This MCIWnd message specifies the
* starting position for playing and sends the MCI_PLAY
* message to an MCI device to begin playing.
*
* @parm WPARAM | wParam | Not used; set to zero.
*
* @parm LPARAM | lParam | Specifies the starting position for the sequence.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm This message starts the device playing. Play continues until it is
* stopped or the device reaches the end of the sequence.
*
* @xref MCIWNDM_PLAYTO
*
***********************************************************************/
/***********************************************************************
* @doc INTERNAL
*
* @msg MCIWNDM_PLAYTO | This MCIWnd message specifies the ending position
* of a playback sequence and sends the MCI_PLAY message to an
* MCI device to begin play.
*
* @parm WPARAM | wParam | Not used; set to zero.
*
* @parm LPARAM | lParam | Specifies the ending position for the sequence.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm This message starts play from the current position. Play stops
* when the sequence reaches the specified position (or the end
* of the sequence if the specified position is beyond the end
* of the sequence).
*
* @xref MCIWNDM_PLAYTO
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_GETFILENAME | This MCIWnd message has an MCI
* device return the filename of its device element.
*
* @parm WPARAM | wParam | Specifies the size of the data buffer.
*
* @parm LPARAM | lParam | Specifies a far pointer to the
* application-supplied data buffer used
* to return the filename.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm If the zero-terminated string containing the filename is
* longer than the buffer, it is truncated.
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_GETDEVICE | This MCIWnd message has an MCI
* device return its device type.
*
* @parm WPARAM | wParam | Specifies the size of the data buffer.
*
* @parm LPARAM | lParam | Specifies a far pointer to the
* application-supplied data buffer used
* to return the device type.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm If the zero-terminated string describing the device type is
* longer than the buffer, MCIWnd truncates it.
*
************************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_GETPALETTE | This MCIWnd message has an MCI
* device return a handle to its palette.
*
* @parm WPARAM | wParam | Not used; set to zero.
*
* @parm LPARAM | lParam | Not used; set to zero.
*
* @rdesc Returns the handle to the palette.
*
* @xref MCIWNDM_SETPALETTE
*
***********************************************************************/
/***********************************************************************
* @doc INTERNAL
*
* @msg MCIWNDM_SETPALETTE | This MCIWnd message sends a palette handle
* to an MCI device.
*
* @parm WPARAM | wParam | Specifies the handle to the palette.
*
* @parm LPARAM | lParam | Not used; set to zero.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @xref MCIWNDM_GETPALETTE
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_GETERROR | This message has MCIWnd return
* the last MCI error associated with its window.
*
* @parm WPARAM | wParam | Specifies the size of the error data buffer.
*
* @parm LPARAM | lParam | Specifies a far pointer to the
* application-supplied data buffer used to return the error.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an integer corresponding to the MCI error code.
*
* @comm If the zero-terminated string describing the error is
* longer than the buffer, it is truncated.
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_SETACTIVETIMER | This message sets the
* period used by MCIWnd to update the scrollbar,
* position information displayed in the window caption,
* and send notification messages to the parent window
* when the MCIWnd is the active window.
*
* @parm WPARAM | wParam | Specifies the integer number of milliseconds
* between updates.
*
* @parm LPARAM | lParam | Not used; set to zero.
*
* @rdesc None.
*
* @xref MCIWNDM_SETINACTIVETIMER MCIWNDM_SETTIMERS
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_SETINACTIVETIMER | This message sets the
* period used by MCIWnd to update the scrollbar,
* position information displayed in the window caption,
* and send notification messages to the parent window
* when the MCIWnd is the inactive window.
*
* @parm WPARAM | wParam | Specifies the integer number of milliseconds
* between updates.
*
* @parm LPARAM | lParam | Not used; set to zero.
*
* @rdesc None.
*
* @xref MCIWNDM_SETACTIVETIMER MCIWNDM_SETTIMERS
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_SETTIMERS | This message sets the
* periods used by MCIWnd to update the scrollbar,
* position information displayed in the window caption,
* and send notification messages to the parent window.
*
* @parm WPARAM | wParam | Specifies the integer number of milliseconds
* between updates when the window is the active window.
*
* @parm LPARAM | lParam | Specifies the integer number of milliseconds
* between updates when the window is the inactive window.
*
* @rdesc None.
*
* @xref MCIWNDM_SETACTIVETIMER MCIWNDM_SETINACTIVETIMER
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_GETACTIVETIMER | This message returns
* the timer period used when the MCIWnd window is the
* active window.
*
* @parm WPARAM | wParam | Not used; set to zero.
*
* @parm LPARAM | lParam | Not used; set to zero.
*
* @rdesc Returns the update period in milliseconds.
* The default is 500 milliseconds.
*
* @xref MCIWNDM_SETACTIVETIMER
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_GETINACTIVETIMER | This message returns
* the timer period used when the MCIWnd window is the
* inactive window.
*
* @parm WPARAM | wParam | Not used; set to zero.
*
* @parm LPARAM | lParam | Not used; set to zero.
*
* @rdesc Returns the update period in milliseconds.
* The default is 2000 milliseconds.
*
* @xref MCIWNDM_SETINACTIVETIMER
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_GETSTYLES | This MCIWnd message returns
* the flags used for specifying the styles used
* for an MCIWnd window.
*
* @parm WPARAM | wParam | Not used; set to zero.
*
* @parm LPARAM | lParam | Not used; set to zero.
*
* @rdesc Returns the flags specifying the styles used for
* the window.
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_CHANGESTYLES | This MCIWnd message
* changes the styles used for the window.
*
* @parm WPARAM | wParam | Specifies a mask for <p lParam>. This
* mask is the bitwise or of all styles that will be updated.
*
* @parm LPARAM | lParam | Specifies the styles used for the window.
* See <f MCIWndCreate> for the available styles.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_GETALIAS | This MCIWnd message returns the alias
* used to open and MCI device or device element.
*
* @parm WPARAM | wParam | Not used; set to zero.
*
* @parm LPARAM | lParam | Not used; set to zero.
*
* @rdesc Returns the device alias.
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_NEW | This MCIWnd message has an MCI device create a new
* file.
*
* @parm WPARAM | wParam | Not used; set to zero.
*
* @parm LPARAM | lParam | Specifies a far pointer to a buffer
* containing the name of the MCI device used to create
* the file.
*
* @rdesc Returns false if successful. Otherwise it returns
* an MCI error code.
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_SETREPEAT | This MCIWnd message has an MCI device
* repeat a sequence.
*
* @parm WPARAM | wParam | Specifies the number of times to repeat a sequence.
*
* @parm LPARAM | lParam | Not used; set to zero.
*
* @rdesc Returns TRUE if successful. Otherwise it returns
* an MCI error code.
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_GETREPEAT | This MCIWnd message has an MCI device
* return the number times it will repeat a sequence.
*
* @parm WPARAM | wParam | Not used; set to zero.
*
* @parm LPARAM | lParam | Not used; set to zero.
*
* @rdesc Returns TRUE if successful. Otherwise it returns
* an MCI error code.
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_REALIZE | This MCIWnd message has an MCI device
* realize its palette.
*
* @parm WPARAM | wParam | Specifies TRUE if the window is a
* background window.
*
* @parm LPARAM | lParam | Not used; set to zero.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_VALIDATEMEDIA | This message has MCIWnd synchronize
* its position information to the new media when it has changed.
*
* @parm WPARAM | wParam | Not used; set to zero.
*
* @parm LPARAM | lParam | Not used; set to zero.
*
* @rdesc None.
*
* @comm If your application changes the time format of a
* device without using MCIWnd, the starting and ending
* position of the media, as well as the trackbar continue to
* use the old format. Use the <f MCIWndValidateMedia>
* macro or the <m MCIWNDM_VALIDATEMEDIA> message to update
* these values. Normally, you should not
* need to use this message.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @msg MCIWNDM_NOTIFYMODE | MCIWND sends this message to
* the parent window of an application to notify
* it that device mode has changed.
*
* @parm WPARAM | WParam | Not used.
*
* @parm LPARAM | LParam | Specifies an integer corresponding to
* the MCI mode.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @msg MCIWNDM_NOTIFYPOS | MCIWND sends this message to
* the parent window of an application to notify it
* that the window position has changed.
*
* @parm WPARAM | WParam | Not used.
*
* @parm LPARAM | LParam | Specifies the new position.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @msg MCIWNDM_NOTIFYSIZE | MCIWND sends this message to
* the parent window of an application to notify it
* that the window size has changed.
*
* @parm HWND | WParam | Specifies a handle to the MCIWnd window that
* has changed size.
*
* @parm LPARAM | LParam | Not used; set to zero.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @msg MCIWNDM_NOTIFYMEDIA | MCIWND sends this message to
* the parent window of an application to notify it
* that the media has changed.
*
* @parm WPARAM | WParam | Not used.
*
* @parm LPARAM | LParam | Specifies a far pointer to
* a zero-terminated string containing the new filename.
* If the media is closing, it specifies a null string.
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @msg MCIWNDM_NOTIFYCLOSE | MCIWND sends this message to
* the parent window of an application to notify it
* that the window is closing.
*
* @parm HWND | WParam | Specifies the window handle.
*
* @parm LPARAM | LParam | Not used; set to zero.
*
***********************************************************************/
/***********************************************************************
*
* @doc EXTERNAL
*
* @msg MCIWNDM_NOTIFYERROR | MCIWND sends this message to
* the parent window of an application to send it an error from MCI.
*
* @parm HWND | WParam | Specifies the window handle.
*
* @parm LPARAM | LParam | Specifies a far pointer to a zero-terminated
* string indicating the error.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndOpen | This macro has MCIWnd open an MCI device.
*
* @parm HWND | hwnd | Specifies the handle to the MCIWnd window.
*
* @parm LPSTR | szFile | Specifies a zero-terminated string for the file name.
* Specifying -1 for this parameter has the MCI device display
* a dialog box used to specify the filename.
*
* @parm WORD | wFlags | Specifies applicable flags for the open.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm This macro is defined with the MCI_OPEN message.
* The <p wParam> parameter for the message is set to <p wFlags>,
* and the <p lParam> parameter for the message is set to
* <p szFile>.
*
* @xref MCIWndClose MCIWndOpenDialog
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndOpenDialog | This macro
* has MCIWnd display a dialog box for specifying the filename
* MCIWnd uses to open an MCI device.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm This macro is defined with the MCI_OPEN message.
* The <p wParam> parameter for the message is set to -1,
* and the <p lParam> parameter for the message is set to zero.
*
* @xref MCIWndClose MCIWndOpen
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndNew | This MCIWnd macro has an MCI device create a new
* file.
*
* @parm HWND | hwnd | Specifies the handle to the MCIWnd window.
*
* @parm LPARAM | lp | Points to the name of the device
* used to create the new file.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm This macro is defined with the MCIWNDM_NEW message.
* The <p wParam> parameter for the message is set to zero,
* and the <p lParam> parameter is set to <p lp>.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndClose | This macro has MCIWnd close an
* MCI device or device element.
*
* @parm HWND | hwnd | Specifies the handle to the MCIWnd window.
*
* @rdesc Returns zero.
*
* @comm Use this macro to close an MCI device
* without destroying the MCIWnd window.
* Use <f MCIWndDestroy> to simultaneously close
* the MCI device and destroy the MCIWnd window.
*
* If your application will immediately open a new MCI device in
* the MCIWnd window, use <f MCIWndOpen> to simultaneously
* close the current MCI device and open a new one.
*
* @comm This macro is defined with the MCI_CLOSE message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
* @xref MCIWndOpen MCIWndDestroy
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api VOID | MCIWndDestroy | This MCIWnd macro closes an MCI device
* or device element and destroys the MCIWnd window.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @comm This macro is defined with the WM_CLOSE message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
* @xref MCIWndOpen MCIWndClose
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api VOID | MCIWndSetZoom | This MCIWnd macro has an MCI device stretch
* a video image.
*
* @parm HWND | hwnd | Specifies the handle to the MCIWnd window.
*
* @parm int | iZoom | Specifies an integer indicating the zoom factor as
* a percentage of the original image. Specifying 100 displays the
* image at its authored sized. Specifying 200 displays the image
* at twice normal size. Specifying 50 displays the image at
* half normal size.
*
* @comm This macro is defined with the MCIWNDM_SETZOOM message.
* The <p wParam> parameter for the message is set to zero,
* and the <p lParam> parameter has the same
* definition as <p iZoom>.
*
* @xref MCIWndGetZoom
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api UINT | MCIWndGetZoom | This MCIWnd macro has an MCI device return
* the zoom factor it is using.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @rdesc Returns an integer corresponding to the zoom factor. A value
* of 100 indicates the image is not zoomed. A value
* of 200 indicates the image is zoomed to twice its
* original size. A value of 50 indicates the image
* is reduced to half its original size.
*
* @comm This macro is defined with the MCIWNDM_GETZOOM message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
* @xref MCIWndSetZoom
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndSendString | This MCIWnd macro sends a string command
* to an MCI device.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @parm LPSTR | sz | Specifies a string to send to the MCI device.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm When sending a string with this macro, omit the
* alias used when the string is sent with <f mciSendString>.
*
* This macro is defined with the MCIWNDM_SENDSTRING message.
* The <p wParam> parameter for the message is set to zero,
* and the <p lParam> parameter has the same
* definition as <p sz>.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndReturnString | This MCIWnd macro obains
* the string information returned by an MCI device.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @parm LPARAM | lp | Specifies a far pointer to the application-supplied
* buffer used to return the zero-terminated string.
*
* @parm int | iLen | Specifies the size of the data buffer.
*
* @rdesc Returns an integer corresponding to the MCI string.
*
* @comm If the zero-terminated string is
* longer than the buffer, it is truncated.
*
* This macro is defined with the MCIWNDM_RETURNSTRING message.
* The <p wParam> parameter for the message has the same
* definition as <p iLen>, and the <p lParam> parameter has the same
* definition as <p lp>.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndSeek | This MCIWnd macro sends the MCI_SEEK message
* to an MCI device to seek to a specified position.
*
* @parm HWND | hwnd | Specifies the handle to the MCIWnd window.
*
* @parm LONG | lPos | Specifies the seek position.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm The units for the seek position depend on the current time format.
*
* This macro is defined with the MCI_SEEK message.
* The <p wParam> parameter for the message is set to zero,
* and the <p lParam> parameter has the same
* definition as <p lPos>.
*
* @xref MCIWndEnd MCIWndHome
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndHome | This MCIWnd macro sends the MCI_SEEK message
* to an MCI device to seek to the start of the media.
*
* @parm HWND | hwnd | Specifies the handle to the MCIWnd window.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm This macro is defined with the MCIWND_START message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
* @xref MCIWndEnd MCIWndSeek
*
**********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndEnd | This MCIWnd macro has
* an MCI device seek to the end of the media.
*
* @parm HWND | hwnd | Specifies the handle to the MCIWnd window.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm This macro is defined with the MCIWND_END message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
* @xref MCIWndHome MCIWndSeek
*
**********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndPlay | This MCIWnd macro has the MCI device
* start playing.
*
* @parm HWND | hwnd | Specifies the handle to the MCIWnd window.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm This macro starts playing from the current position.
*
* @comm This macro is defined with the MCI_PLAY message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
* @xref MCIWndPlayReverse MCIWndPlayFrom MCIWndPlayTo MCIWndPlayFromTo
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndPlayFrom | This MCIWnd macro specifies the
* starting position for playing and has the MCI device
* start playing.
*
* @parm HWND | hwnd | Specifies the handle to the MCIWnd window.
*
* @parm LONG | lPos | Specifies the starting position for the sequence.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm This macro starts play from the specified position.
* Playing continues until it is
* stopped or play reaches the end of the sequence.
*
* This macro is defined with the MCIWNDM_PLAYFROM message.
* The <p wParam> parameter for the message is set to zero,
* and the <p lParam> parameter has the same
* definition as <p lPos>.
*
* @xref MCIWndPlay MCIWndPlayReverse MCIWndPlayTo MCIWndPlayFromTo
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndPlayFromTo | This MCIWnd macro specifies the
* starting and ending positions for playing a sequence and
* has the MCI device start playing.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @parm LONG | lStart | Specifies the starting position for the sequence.
*
* @parm LONG | lEnd | Specifies the ending position for the sequence.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm This macro seeks to the starting position then starts playing.
* Play stops when the sequence reaches the specified position
* (or the end of the sequence if the specified position is
* beyond the end of the sequence).
*
* This macro is defined with the MCIWndSeek and MCIWndPlayTo
* macros.
*
* @xref MCIWndPlay MCIWndPlayFrom MCIWndPlayReverse MCIWndPlayTo
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndPlayTo | This MCIWnd macro specifies the ending position
* for playing and has the MCI device start playing.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @parm LONG | lPos | Specifies the ending position for the sequence.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm This macro starts play from the current position. Play stops
* when the sequence reaches the specified position (or the end
* of the sequence if the specified position is beyond the end
* of the sequence).
*
* This macro is defined with the MCWINDM_PLAYTO message.
* The <p wParam> parameter is set to zero for the message,
* and the <p lParam> parameter has the same
* definition as <p lPos>.
*
* @xref MCIWndPlay MCIWndPlayFrom MCIWndPlayTo MCIWndPlayFromTo
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndPlayReverse | This MCIWnd macro
* has the MCI device start playing the sequence in reverse.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm This macro starts play from the current position. Play stops
* when the sequence reaches the begining of the file or it is
* stopped.
*
* @comm This macro is defined with the MCI_PLAYREVERSE message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
* @xref MCIWndPlay MCIWndPlayFrom MCIWndPlayTo MCIWndPlayFromTo
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndStop | This MCIWnd macro has and MCI device
* stop playing or recording.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm This macro is defined with the MCI_STOP message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndPause | This MCIWnd macro has an
* MCI device pause playing or recording.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm This macro is defined with the MCI_PAUSE message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndResume | This MCIWnd macro
* has an MCI device continue playing or recording.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm This macro is defined with the MCI_RESUME message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
***********************************************************************/
/***********************************************************************
*
* @doc EXTERNAL
*
* @api LRESULT | MCIWndCanRecord | This MCIWnd macro determines if an MCI device
* supports recording.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @rdesc Returns TRUE if the device supports recording. Otherwise it returns
* an MCI error code.
*
* @comm This macro is defined with the MCIWNDM_CAN_RECORD message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
************************************************************************/
/***********************************************************************
*
* @doc EXTERNAL
*
* @api LRESULT | MCIWndCanSave | This macro determines if an MCI device
* can save data.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @rdesc Returns TRUE if the device supports saving data. Otherwise it returns
* an MCI error code.
*
* @comm This macro is defined with the MCIWNDM_CAN_SAVE message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
*
***********************************************************************/
/***********************************************************************
*
* @doc EXTERNAL
*
* @api LRESULT | MCIWndCanPlay | This macro determines if an MCI device
* supports playing a sequence.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @rdesc Returns TRUE if the device supports playing data. Otherwise it returns
* an MCI error code.
*
* @comm This macro is defined with the MCIWNDM_CAN_PLAY message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
***********************************************************************/
/***********************************************************************
*
* @doc EXTERNAL
*
* @api LRESULT | MCIWndCanEject | This macro determines if an MCI device
* can eject its media.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @rdesc Returns TRUE if the device can eject its media. Otherwise it returns
* an MCI error code.
*
*
* @comm This macro is defined with the MCIWNDM_CAN_EJECT message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
***********************************************************************/
/***********************************************************************
*
* @doc EXTERNAL
*
* @api LRESULT | MCIWndCanConfig | This macro determines if an MCI device
* supports configuration.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @rdesc Returns TRUE if the device supports configuration. Otherwise it returns
* an MCI error code.
*
*
* @comm This macro is defined with the MCIWNDM_CAN_CONFIG message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @api LRESULT | MCIWndCanVolume | This macro determines if an MCI device
* supports volume changes.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @rdesc Returns TRUE if the device supports changing it volume level. Otherwise it returns
* an MCI error code.
*
***********************************************************************/
/***********************************************************************
*
* @doc EXTERNAL
*
* @api LRESULT | MCIWndCanWindow | This macro determines if an MCI device
* supports window commands.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @rdesc Returns TRUE if the device supports windowing operations. Otherwise it returns
* an MCI error code.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndRecord | This MCIWnd macro has
* an MCI device start recording.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm This macro starts recording from the current position.
*
* @comm This macro is defined with the MCI_RECORD message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
* @xref MCIWndStop MCIWndPause
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @api LONG | MCIWndRecordFrom | This macro specifies the starting position
* for recording and sends the MCI_RECORD message
* to an MCI device to start recording.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @parm LONG | lStart | Specifies the starting position for recording.
*
* @rdesc Returns TRUE if successful. Otherwise it returns
* an MCI error code.
*
* @comm This macro starts record from the specified position.
* Recording continues until it is
* stopped or record reaches the end of the record file.
*
* @xref MCIWndRecord MCIWndRecordTo MCIWndRecordFromTo MCIWndRecordPreview
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @api LONG | MCIWndRecordFromTo | This macro specifies the starting and ending
* positions for recording a sequence and sends the MCI_RECORD message
* to an MCI device to start recording.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @parm LONG | lStart | Specifies the starting position for recording.
*
* @parm LONG | lEnd | Specifies the ending position for recording.
*
* @rdesc Returns TRUE if successful. Otherwise it returns
* an MCI error code.
*
* @comm This macro seeks to the starting position then starts recording.
* Recording stops when the sequence reaches the specified position
* (or the end of the sequence if the specified position is
* beyond the end of the sequence).
*
* @xref MCIWndRecord MCIWndRecordFrom MCIWndRecordTo MCIWndRecordPreview
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @api LONG | MCIWndRecordTo | This macro specifies the ending position
* for recording and sends the MCI_RECORD message
* to an MCI device to start recording.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @parm LONG | lPos | Specifies the ending position for recording.
*
* @rdesc Returns TRUE if successful. Otherwise it returns
* an MCI error code.
*
* @comm This macro starts recording from the current position. Record stops
* when the sequence reaches the specified position (or the end
* of the sequence if the specified position is beyond the end
* of the sequence).
*
* @xref MCIWndRecord MCIWndRecordFrom MCIWndRecordFromTo MCIWndRecordPreview
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @api LRESULT | MCIWndRecordPreview | This macro previews the input
* used for recording.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @rdesc Returns TRUE if successful. Otherwise it returns
* an MCI error code.
*
* @comm This macro does not initiate recording.
*
* @xref MCIWndRecordFrom MCIWndRecordTo MCIWndRecordFromTo MCIWndRecordPreview
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndSave | This MCIWnd macro has an
* MCI device save its data.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @parm LPSTR | szFile | Specifies a zero-terminated string containing
* the name and path of the destination file. Specifying -1 for
* this parameter has the device display its dialog box for
* specifying the filename.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* This macro is defined with the MCI_SAVEE message.
* The <p wParam> parameter for the message is set to zero,
* and the <p lParam> parameter has the same
* definition as <p szFile>.
*
* @xref MCIWndSaveDialog
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndSaveDialog | This MCIWnd macro displays
* a dialog box for specifying the filename used to save data
* and has the MCI device save the data.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* This macro is defined with the MCIWNDM_SAVE message.
* The <p wParam> parameter for the message is set to zero,
* and the <p lParam> parameter is set to -1.
*
* @xref MCIWndSave
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @api LRESULT | MCIWndSetFormat | This macro has an MCI
* device set its format data.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @parm HWND | lp | Specifies a far pointer to the format data buffer.
*
* @parm int | cb | Specifies the size of the format data buffer.
*
* @rdesc Returns TRUE if successful. Otherwise it returns
* an MCI error code.
*
* @xref MCIWndGetFormat MCIWndFormatDialog
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @api LRESULT | MCIWndGetFormat | This macro has an MCI
* device return its format data.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @parm LPARAM | lp | Specifies a far pointer to the format data buffer.
*
* @parm int | cb | Specifies the size of the format data buffer.
*
* @rdesc Returns TRUE if successful. Otherwise it returns
* an MCI error code.
*
* @xref MCIWndSetFormat MCIWndFormatDialog
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @api LRESULT | MCIWndFormatDialog | This macro has an MCI
* device display a dialog box for setting its format data.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @rdesc Returns TRUE if successful. Otherwise it returns
* an MCI error code.
*
* @xref MCIWndSetFormat MCIWndGetFormat
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndEject | This MCIWnd macro has an MCI
* device eject its media.
*
* @parm HWND | hwnd | Specifies the handle to the MCIWnd window.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm This macro is defined with the MCWINDM_EJECT message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api UINT | MCIWndGetDeviceID | This MCIWnd macro has an MCI
* device return its device ID.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @rdesc Returns the device ID.
*
* @comm This macro is defined with the MCIWNDM_GETDEVICEID message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api UINT | MCIWndGetAlias | This MCIWnd macro returns the
* alias used to open an MCI device or device element.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @rdesc Returns the device alias.
*
* @comm This macro is defined with the MCIWNDM_GETALIAS message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndGetMode | This MCIWnd macro has an MCI
* device return its mode.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @parm LPARAM | lp | Specifies a far pointer to the application-supplied
* buffer used to return the mode.
*
* @parm int | iLen | Specifies the size of the data buffer.
*
* @rdesc Returns an integer corresponding to the MCI constant
* defining the mode.
*
* @comm If the zero-terminated string describing the mode is
* longer than the buffer, it is truncated.
*
* This macro is defined with the MCIWNDM_GETMODE message.
* The <p wParam> parameter for the message has the same
* definition as <p iLen>, and the <p lParam> parameter has the same
* definition as <p lp>.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndGetPosition | This MCIWnd macro
* returns the current position of the MCI device element.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @rdesc Returns the current position.
*
* @comm The units for the position value depend on the current time format.
*
* @comm This macro is defined with the MCIWNDM_GETPOSITION message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndGetPositionString | This MCIWnd macro
* returns the current position of the MCI device element
* in a string format.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @parm LPARAM | lp | Specifies a far pointer to the application-supplied
* buffer used to return the zero-terminated string.
*
* @parm int | iLen | Specifies the size of the data buffer.
*
* @rdesc Returns an integer corresponding to the position.
*
* @comm If the device supports tracks, the position information
* is returned in the TT:MM:SS:FF format where TT corresponds
* to tracks, MM and SS corresponds to minutes and seconds, and
* FF corresponds to frames.
*
* If the zero-terminated string is
* longer than the buffer, it is truncated.
*
* This macro is defined with the MCIWNDM_GETPOSITION message.
* The <p wParam> parameter for the message has the same
* definition as <p iLen>, and the <p lParam> parameter has the same
* definition as <p lp>.
*
*
* @comm The units for the position value depend on the current time format.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndGetStart | This MCIWnd macro returns
* the starting position of an MCI device element.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @rdesc Returns the starting position of the device element.
*
* @comm Typically, the return value is zero but some devices
* use a non-zero starting position for the device
* element. Seeking to this position sets the device
* to the start of the media.
*
* This macro is defined with the MCIWNDM_GETSTART message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndGetLength | This MCIWnd macro returns
* the length of an MCI device element.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @rdesc Returns the length of the device element.
*
* @comm This value plus the value returned for <f MCIWndGetStart>
* equals the end of the media.
*
* @comm This macro is defined with the MCIWNDM_GETLENGTH message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndGetEnd | This MCIWnd macro returns
* the ending position of an MCI device element.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @rdesc Returns the ending position.
*
* @comm This macro is defined with the MCIWNDM_GETEND message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndStep | This MCIWnd macro steps
* an MCI device element.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @parm LPARAM | n | Specifies the number of frames or
* milliseconds to step. Negative
* values step the device element in reverse.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm The units for the step value depend on the current time format.
*
* @comm This macro is defined with the MCI_STEP message.
* The <p wParam> parameter is set to zero and the <p lParam>
* has the same definition as <p n>.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndSetVolume | This MCIWnd macro sets the
* volume level of an MCI device.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @parm int | iVol | Specifies the volume level. Specify 1000
* for the normal volume level. Specify larger values to increase
* the volume level and smaller values to decrease the volume level.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm This macro is defined with the MCIWNDM_SETVOLUME message.
* The <p wParam> parameter for the message is set to zero,
* and the <p lParam> parameter has the same
* definition as <p iVol>.
*
* @xref MCIWndGetVolume
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndGetVolume | This MCIWnd macro returns
* volume level of an MCI device.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @rdesc Returns the volume level.
*
* @comm This macro is defined with the MCIWNDM_GETVOLUME message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
* @xref MCIWndSetVolume
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndSetSpeed | This MCIWnd macro sets
* the playback speed of an MCI device.
*
* @parm HWND | hwnd | Specifies the handle to the MCIWnd window.
*
* @parm int | iSpeed | Specifies the playback speed. Specify 1000
* for the normal speed. Specify larger values for faster speeds
* and smaller values for slower speeds.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm This macro is defined with the MCIWNDM_SETSPEED message.
* The <p wParam> parameter for the message is set to zero,
* and the <p lParam> parameter has the same
* definition as <p iSpeed>.
*
* @xref MCIWndGetSpeed
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndGetSpeed | This MCIWnd macro returns the
* playback speed of an MCI device.
*
* @parm HWND | hwnd | Specifies the handle to the MCIWnd window.
*
* @rdesc Returns the playback speed.
*
* @comm This macro is defined with the MCIWNDM_GETSPEED message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
* @xref MCIWndSetSpeed
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndSetTimeFormat | This MCIWnd macro
* specifies time fomat used by an MCI device.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @parm LPSTR | lp | Specifies a far pointer to a data buffer
* containing the zero-terminated string indicating the time format.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm Application can specify formats other than frames and
* milliseconds if they are supported by the MCI device.
* Non-continuous formats, such as tracks and
* SMPTE can cause the scroll bar to behave erratically.
* For these time formats, applications might change the
* window style by using MCIWNDF_NOPLAYBAR to turn off the
* playbar.
*
* This macro is defined with the MCIWNDM_SETTIMEFORMAT message.
* The <p wParam> parameter for the message is set to zero,
* and the <p lParam> parameter has the same
* definition as <p lp>.
*
* @xref MCIWndGetTimeFormat MCIWndUseFrames MCIWndUseTime
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndUseFrames | This MCIWnd macro has an MCI
* device set its time format to frames.
*
* @parm HWND | hwnd | Specifies the handle to the MCIWnd window.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* This macro is defined with the MCIWNDM_SETTIMEFORMAT message.
* The <p wParam> parameter for the message is set to zero,
* and the <p lParam> parameter is set to "frames".
*
* @xref MCIWndSetTimeFormat
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndUseTime | This MCIWnd macro has an MCI
* device set its time format to milliseconds.
*
* @parm HWND | hwnd | Specifies the handle to the MCIWnd window.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* This macro is defined with the MCIWNDM_SETTIMEFORMAT message.
* The <p wParam> parameter for the message is set to zero,
* and the <p lParam> parameter is set to "ms".
*
* @xref MCIWndSetTimeFormat
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndGetTimeFormat | This macro returns the time
* format of an MCI device in an application-supplied buffer.
*
* @parm HWND | hwnd | Specifies the handle to the MCIWnd window.
*
* @parm LPARAM | lp | Specifies a far pointer to the data buffer used
* to return the zero-terminated string indicating time format.
*
* @parm int | iLen | Specifies the size of the data buffer.
*
* @rdesc Returns an integer corresponding to the MCI constant
* defining the time format.
*
* @comm If the time format string is longer than the return buffer,
* MCIWnd truncates the string.
*
* This macro is defined with the MCIWNDM_GETTIMEFORMAT message.
* The <p wParam> parameter for the message has the same
* definition as <p iLen>, and the <p lParam> parameter has the same
* definition as <p lp>.
*
* @xref MCIWndSetTimeFormat
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api VOID | MCIWndSetActiveTimer | This MCIWnd macro sets the
* period used by MCIWnd to update the scrollbar,
* position information displayed in the window caption,
* and send notification messages to the parent window
* when the MCIWnd window is the active window.
*
* @parm HWND | hwnd | Specifies the handle to the MCIWnd window.
*
* @parm int | iActive | Specifies an integer timer period in milliseconds.
*
* @comm This macro is defined with the MCIWNDM_SETACTIVETIMER message.
* The <p wParam> parameter for the message has the same
* definition as <p iACTIVE>, and the <p lParam> parameter
* is set to zero.
*
* @xref MCIWndSetInactiveTimer MCIWndSetTimers
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api VOID | MCIWndSetInactiveTimer | This MCIWnd macro sets
* the period used by MCIWnd to update the scrollbar,
* position information displayed in the window caption,
* and send notification messages to the parent window
* when the MCIWnd window is the inactive window.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @parm int | iInactive | Specifies an integer timer period in milliseconds.
*
* @comm This macro is defined with the MCIWNDM_SETINACTIVETIMER message.
* The <p wParam> parameter for the message has the same
* definition as <p iInactive>, and the <p lParam> parameter
* is set to zero.
*
* @xref MCIWndSetActiveTimer MCIWndSetTimers
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api VOID | MCIWndSetTimers | This MCIWnd macro sets the time
* periods used by MCIWnd to update the scrollbar, position
* information displayed in the window caption,
* and send notification messages to the parent window.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @parm int | iActive | Specifies an integer timer period used
* by MCIWnd when it is the active window. This value
* is limited to 16 bits.
*
* @parm int | iInactive | Specifies an integer timer period used
* by MCIWnd when it is the inactive window. This value
* is limited to 16 bits.
*
* This macro is defined with the MCIWNDM_SETTIMERS message.
* The <p wParam> parameter for the message has the same
* definition as <p iActive>, and the <p lParam> parameter has the same
* definition as <p iInactive>.
*
* @xref MCIWndSetActiveTimer MCIWndSetInactiveTimer
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api UINT | MCIWndGetActiveTimer | This MCIWnd macro returns
* the timer period used when the MCIWnd window is
* the active window.
*
* @parm HWND | hwnd | Specifies the handle to the MCIWnd window.
*
* @rdesc Returns the update period in milliseconds.
* The default is 500 milliseconds.
*
* @comm This macro is defined with the MCIWNDM_GETACTIVETIMER message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
* @xref MCIWndSetActiveTimer MCIWndSetTimers MCIWndGetInactiveTimer
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api UINT | MCIWndGetInactiveTimer | This MCIWnd macro returns
* the timer period used when the MCIWnd window is
* the inactive window.
*
* @parm HWND | hwnd | Specifies the handle to the MCIWnd window.
*
* @rdesc Returns the timer period in milliseconds.
* The default is 2000 milliseconds.
*
* @comm This macro is defined with the MCIWNDM_GETINACTIVERTIMER message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
* @xref MCIWndSetInactiveTimer MCIWndSetTimers MCIWndGetActiveTimer
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndGetError | This MCIWnd macro returns the last MCI
* error encountered.
*
* @parm HWND | hwnd | Specifies the handle to the MCIWnd window.
*
* @parm LPARAM | lp | Specifies a far pointer to an application-supplied
* buffer used to return the error string.
*
* @parm int | iLen | Specifies the size of the error data buffer.
*
* @rdesc Returns the integer error code.
*
*@comm If <p lp> is a valid pointer, a zero-terminated string
* corresponding to the error is returned in its buffer. If
* the error string is longer than the buffer, MCIWnd truncates it.
*
* This macro is defined with the MCIWNDM_GETERROR message.
* The <p wParam> parameter for the message has the same
* definition as <p iLen>, and the <p lParam> parameter has the same
* definition as <p lp>.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api HPALETTE | MCIWndGetPalette | This MCIWnd macro returns
* a handle to the palette used by an MCI device.
*
* @parm HWND | hwnd | Specifies the handle to the MCIWnd window.
*
* @rdesc Returns the handle to the palette.
*
* @comm This macro is defined with the MCIWNDM_GETPALETTE message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
* @xref MCIWndSetPalette
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndSetPalette | This MCIWnd macro sends a palette handle
* to an MCI device.
*
* @parm HWND | hwnd | Specifies the handle to the MCIWnd window.
*
* @parm HPALETTE | hpal | Specifies the handle to the palette.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm This macro is defined with the MCIWNDM_SETPALETTE message.
* The <p wParam> parameter for the message has the same
* definition as <p hpal>, and the <p lParam> parameter
* is set to zero.
*
* @xref MCIWndGetPalette
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndGetFileName | This MCIWnd macro returns
* the filename used by an MCI device element.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @parm LPARAM | lp | Specifies a far pointer to the
* application-supplied data buffer used
* to return the filename.
*
* @parm int | iLen | Specifies the size of the data buffer.
*
* @rdesc Returns zero if successful. Otherwise it returns one.
*
* @comm If the zero-terminated string containing the filename is
* longer than the buffer, MCIWnd truncates it.
*
* This macro is defined with the MCIWNDM_GETFILENAME message.
* The <p wParam> parameter for the message has the same
* definition as <p iLen>, and the <p lParam> parameter has the same
* definition as <p lp>.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndGetDevice | This MCIWnd macro returns the
* name of the currently opened MCI device.
*
* @parm HWND | hwnd | Specifies the handle to the MCIWnd window.
*
* @parm LPARAM | lp | Specifies a far pointer to the application-supplied
* data buffer used to return the device name.
*
* @parm int | len | Specifies the size of the data buffer.
*
* @rdesc Returns zero if successful. Otherwise it returns 42.
*
* @comm If the zero-terminated string containing the device name is
* longer than the buffer, MCIWnd truncates it.
*
* This macro is defined with the MCIWNDM_GETDEVICE message.
* The <p wParam> parameter for the message has the same
* definition as <p len>, and the <p lParam> parameter has the same
* definition as <p lp>.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api UINT | MCIWndGetStyles | This MCIWnd macro returns
* the flags specifying the styles used
* for its window.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @rdesc Returns the flags specifying the styles used for
* the window. This value is the bitwise or of the MCIWNDF flags.
*
* @comm This macro is defined with the MCIWNDM_GETSTYLES message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
* @xref MCIWndChangeStyles MCIWndCreate
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndChangeStyles | This MCIWnd macro changes
* the styles used for its window.
*
* @parm HWND | hwnd | Specifies the handle to the MCIWnd window.
*
* @parm int | mask | Specifies a mask for <p value>. This
* mask is the bitwise or of all styles that will be
* permitted to change.
*
* @parm int | value | Specifies the styles used for the window.
* See <f MCIWndCreate> for the available styles.
*
* @rdesc Returns zero.
*
* @comm This macro is defined with the MCIWNDM_CHANGESTYLES message.
* The <p wParam> parameter for the message has the same
* definition as <p mask>, and the <p lParam> parameter has the same
* definition as <p value>.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api VOID | MCIWndValidateMedia | This macro has MCIWnd synchronize
* its position information to the new media when it has changed.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @comm If your application changes the time format of a
* device without using MCIWnd, the starting and ending
* position of the media, as well as the trackbar continue to
* use the old format. Use the <f MCIWndValidateMedia>
* macro to update these values. Normally, you should not
* need to use this macro.
*
* This macro is defined with the MCIWNDM_VALIDATEMEDIA message.
* The <p wParam> and <p lParam> parameters for the message
* are set to zero.
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @api LONG | MCIWndGetRepeat | This macro obtains the number
* of times the MCI device will repeat a sequence.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @rdesc Returns an integer indicating the number of times
* the MCI device will repeat a sequence.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndRealize | This MCIWnd macro has an MCI
* device realize its pallette.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @parm BOOL | fBkgnd | Set to TRUE to if the window is
* a background application.
*
* @rdesc Returns zero if successful. Otherwise it returns
* an MCI error code.
*
* @comm Call this macro from the WM_PALETTECHANGED
* and WM_QUERYNEWPALETTE message handlers instead of using
* <f RealizePalette>. This MCIWnd macro uses
* the palette of the MCI device and calls <f RealizePalette>.
* If realizing the palette is the only purpose of your
* WM_PALETTECHANGED and WM_QUERYNEWPALETTE message handlers,
* just pass the WM_PALETTECHANGED and WM_QUERYNEWPALETTE messages
* on to the MCI window and it will automatically realize the palette.
*
* This macro is defined with the MCIWNDM_REALIZE message.
* The <p wParam> parameter for the message has the same
* definition as <p fBkgnd>, and the <p lParam> parameter
* is set to zero.
*
***********************************************************************/
/***********************************************************************
*
* @doc INTERNAL
*
* @api VOID | MCIWndActivate | This macro has an MCI
* device activate its window.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @parm int | f | Specifies applicable flags.
*
* @rdesc Returns TRUE if successful. Otherwise it returns
* an MCI error code.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndPutSource | This MCIWnd macro specifies the
* source rectangle for an MCI device.
*
* @parm HWND | hwnd | Specifies the handle to the MCIWnd window.
*
* @parm RECT | prc | Specifies a rectangle indicating image
* source.
*
* @rdesc Returns zero if successful. Otherwise it returns an error.
*
* @comm This macro is defined with the MCIWNDM_PUT_SOURCE message.
* The <p wParam> parameter is set to zero and the <p lParam>
* has the same definition as <p prc>.
*
* @xref MCIWndGetSource
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndGetSource | This MCIWnd macro has an MCI device return
* the rectangle used for the source of the image.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @parm LPRECT | prc | Specifies a pointer to a <t RECT> data type
* used to return the source rectangle.
*
* @rdesc Returns zero if successful. Otherwise it returns an error.
*
* @comm This macro is defined with the MCIWNDM_GET_SOURCE message.
* The <p wParam> parameter is set to zero and the <p lParam>
* has the same definition as <p prc>.
*
* @xref MCIWndPutSource
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndPutDest | This MCIWnd macro specifies the
* destination rectangle for an MCI device.
*
* @parm HWND | hwnd | Specifies the handle to the MCIWnd window.
*
* @parm RECT | prc | Specifies a rectangle indicating image
* destination.
*
* @rdesc Returns zero if successful. Otherwise it returns an error.
*
* @comm This macro is defined with the MCIWNDM_PUT_DEST message.
* The <p wParam> parameter is set to zero and the <p lParam>
* has the same definition as <p prc>.
*
* @xref MCIWndGetDest
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api LONG | MCIWndGetDest | This MCIWnd macro has an MCI device return
* the rectangle used for the image destination.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @parm LPRECT | prc | Specifies a pointer to a <t RECT> data
* type used to return the destination rectangle.
*
* @rdesc Returns zero if successful. Otherwise it returns an error.
*
* @comm This macro is defined with the MCIWNDM_GET_DEST message.
* The <p wParam> parameter is set to zero and the <p lParam>
* has the same definition as <p prc>.
*
* @xref MCIWndPutDest
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api void | MCIWndSetRepeat | This MCIWnd macro has an MCIWnd
* repeat a play sequence subsequently specified with an
* MCIWndPlay macro.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @rdesc Returns TRUE if the flag is set.
*
* @comm This macro is defined with the MCIWNDM_SETREPEAT message.
* The <p wParam> and <p lParam> parameters are set to zero.
*
***********************************************************************/
/***********************************************************************
* @doc EXTERNAL
*
* @api BOOL | MCIWndGetRepeat | This MCIWnd macro returns the status
* of the MCIWnd repeat flag.
*
* @parm HWND | hwnd | Specifies the handle to the MCI window.
*
* @parm BOOL | f | Set to TRUE to if MCIWnd is to continuously repeat
* a sequence.
*
* @comm This macro is defined with the MCIWNDM_SETREPEAT message.
* The <p wParam> parameter for the message is set to zero,
* and the <p lParam> parameter has the same definition
* as <p f>.
*
***********************************************************************/