Share via


MMIOM_WRITEFLUSH

The MMIOM_WRITEFLUSH message is sent to an I/O procedure by the mmioWrite function to request that data be written to an open file and that any internal buffers used by the I/O procedure be flushed to disk.

MMIOM_WRITEFLUSH 
lParam1 = (LPARAM) lpBuffer 
lParam2 = (LPARAM) cbWrite 

Parameters

lpBuffer

Pointer to a buffer containing the data to write to the file.

cbWrite

Number of bytes to write to file.

Return Values

Returns the number of bytes actually written to the file. If there is an error, the return value is - 1.

Remarks

The I/O procedure is responsible for updating the lDiskOffset member of the MMIOINFO structure to reflect the new file position after the write operation.

This message is equivalent to the MMIOM_WRITE message except that it requests that the I/O procedure flush its internal buffers, if any. Unless an I/O procedure performs internal buffering, this message can be handled exactly like the MMIOM_WRITE message.

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

mmioWrite, MMIOINFO, MMIOM_WRITE