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
Pointer to 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 |
Requirements
** Windows NT/2000/XP:** Included in Windows NT 3.1 and later.
** Windows 95/98/Me:** Included in Windows 95 and later.
** Header:** Declared in Vfw.h.
** Unicode:** Declared as Unicode and ANSI messages.
See Also