MCIWndGetTimeFormat
The MCIWndGetTimeFormat macro retrieves the current time format of an MCI device in two forms: as a numerical value and as a string. You can use this macro or explicitly send the MCIWNDM_GETTIMEFORMAT message.
LONG MCIWndGetTimeFormat(
hwnd,
lp,
len
);
Parameters
hwnd
Handle of the MCIWnd window.
lp
Pointer to a buffer to contain the null-terminated string form of the time format.
len
Size, in bytes, of the buffer.
Return Values
Returns an integer corresponding to the MCI constant defining the time format.
Remarks
If the time format string is longer than the return buffer, MCIWnd truncates the string.
An MCI device can support one or more of the following time formats:
| Time format | MCI constant |
| Bytes | MCI_FORMAT_BYTES |
| Frames | MCI_FORMAT_FRAMES |
| Hours, minutes, seconds | MCI_FORMAT_HMS |
| Milliseconds | MCI_FORMAT_MILLISECONDS |
| Minutes, seconds, frames | MCI_FORMAT_MSF |
| Samples | MCI_FORMAT_SAMPLES |
| SMPTE 24 | MCI_FORMAT_SMPTE_24 |
| SMPTE 25 | MCI_FORMAT_SMPTE_25 |
| SMPTE 30 drop | MCI_FORMAT_SMPTE_30DROP |
| SMPTE 30 (non-drop) | MCI_FORMAT_SMPTE_30 |
| Tracks, minutes, seconds, frames | MCI_FORMAT_TMSF |
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.
See Also