mmioRead function

The mmioRead function reads a specified number of bytes from a file opened by using the mmioOpen function.

Syntax

LONG mmioRead(
   HMMIO hmmio,
   HPSTR pch,
   LONG  cch
);

Parameters

  • hmmio
    File handle of the file to be read.

  • pch
    Pointer to a buffer to contain the data read from the file.

  • cch
    Number of bytes to read from the file.

Return value

Returns the number of bytes actually read. If the end of the file has been reached and no more bytes can be read, the return value is 0. If there is an error reading from the file, the return value is –1.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Mmsystem.h (include Windows.h)

Library

Winmm.lib

DLL

Winmm.dll