mmioFlush

The mmioFlush function writes the I/O buffer of a file to disk if the buffer has been written to.

MMRESULT mmioFlush(
  HMMIO hmmio,  
  UINT fuFlush  
);
 

Parameters

hmmio

File handle of a file opened by using the mmioOpen function.

fuFlush

Flag determining how the flush is carried out. It can be zero or the following:

Value	Description
MMIO_EMPTYBUF	Empties the buffer after writing it to the disk.

Return Values

Returns zero if successful or an error otherwise. Possible error values include the following:

Remarks

Closing a file with the mmioClose function automatically flushes its buffer.

If there is insufficient disk space to write the buffer, mmioFlush fails, even if the preceding calls of the mmioWrite function were successful.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in mmsystem.h.
  Import Library: Use winmm.lib.

See Also

Multimedia File I/O Overview, Multimedia File I/O Functions, mmioOpen, mmioClose, mmioWrite