MCIWndGetMode macro (vfw.h)
The MCIWndGetMode macro retrieves the current operating mode of an MCI device. MCI devices have several operating modes, which are designated by constants. You can use this macro or explicitly send the MCIWNDM_GETMODE message.
Syntax
void MCIWndGetMode(
hwnd,
lp,
len
);
Parameters
hwnd
Handle of the MCIWnd window.
lp
Pointer to the application-defined buffer used to return the mode.
len
Size, in bytes, of the buffer.
Return value
None
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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | vfw.h |