MCI_MAKE_HMS

  • Article

The MCI_MAKE_HMS macro creates a time value in packed hours/minutes/seconds (HMS) format from the given hours, minutes, and seconds values.

DWORD MCI_MAKE_HMS(
  BYTE hours,   
  BYTE minutes, 
  BYTE seconds  
);

Parameters

hours

Number of hours.

minutes

Number of minutes.

seconds

Number of seconds.

Return Values

Returns the time in packed HMS format.

Remarks

Time in HMS format is expressed as a DWORD value with the least significant byte containing hours, the next least significant byte containing minutes, and the next least significant byte containing seconds. The most significant byte is unused.

The MCI_MAKE_HMS macro is defined as follows:

#define MCI_MAKE_HMS(h, m, s) ((DWORD)(((BYTE)(h) | \ 
                              ((WORD)(m) << 8)) | \ 
                              (((DWORD)(BYTE)(s)) << 16)))

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 Mmsystem.h; include Windows.h.

See Also

MCI, MCI Macros