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
Address of a buffer containing the data to write to the file.
cbWrite
Number of bytes to write to file.l

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.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in mmsystem.h.

See Also

Multimedia File I/O Overview, Multimedia File I/O Messages, mmioWrite, MMIOINFO, MMIOM_WRITE