mmioSetInfo

The mmioSetInfo function updates the information retrieved by the mmioGetInfo function about a file opened by using the mmioOpen function. Use this function to terminate direct buffer access of a file opened for buffered I/O.

MMRESULT mmioSetInfo(
  HMMIO hmmio,            
  LPMMIOINFO lpmmioinfo,  
  UINT wFlags             
);

Parameters

hmmio

File handle of the file.

lpmmioinfo

Pointer to an MMIOINFO structure filled with information by the mmioGetInfo function.

wFlags

Reserved; must be zero.

Return Values

Returns zero if successful or an error otherwise.

Remarks

If you have written to the file I/O buffer, set the MMIO_DIRTY flag in the dwFlags member of the MMIOINFO structure before calling mmioSetInfo to terminate direct buffer access. Otherwise, the buffer will not get flushed to disk.

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.
  Library: Use Winmm.lib.

See Also

mmioGetInfo, mmioOpen, MMIOINFO

Show: