MCIWNDM_GETMODE

The MCIWNDM_GETMODE message retrieves the current operating mode of an MCI device. MCI devices have several operating modes, which are designated by constants. You can send this message explicitly or by using the MCIWndGetMode macro.

MCIWNDM_GETMODE 
wParam = (WPARAM) (UINT) len; 
lParam = (LPARAM) (LPSTR) lp; 
 

Parameters

len
Size, in bytes, of the buffer.
lp
Address of the application-defined buffer used to return the mode.

Return Values

Returns an integer corresponding to the MCI constant defining the mode.

Remarks

If the null-terminated string describing the mode is longer than the buffer, it is truncated.

Not all devices can operate in every mode. For example, the MCIAVI device is a playback device; it doesn't support the recording mode. The following modes can be retrieved by using MCIWNDM_GETMODE:

Operating mode MCI constant
not ready MCI_MODE_NOT_READY
open MCI_MODE_OPEN
paused MCI_MODE_PAUSE
playing MCI_MODE_PLAY
recording MCI_MODE_RECORD
seeking MCI_MODE_SEEK
stopped MCI_MODE_STOP

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in vfw.h.
  Unicode: Defined as Unicode and ANSI messages.

See Also

MCIWnd Window Class Overview, MCIWnd Messages, MCIWndGetMode