MmioClose

MMRESULT mmioClose( HMMIO hmmio, UINT wFlags );

Возвращаемое значение

В случае успешного завершения работы возвращает нулевое значение. В противном случае возвращает значение ошибки, которая может быть вызвана использованием функции mmioFlush или процедуры ввода/вывода. Возвращаемое значение может принимать одно из следующих значений:

• MMIOERR_CANNOTWRITE — содержимое буфера не может быть записано на диск.

Аргументы

0. hmmio — дескриптор закрываемого файла.

1. wFlags — флаги закрытия файла. Определены следующие значения:

• MMIO_FHOPEN — если для открытия файла использовался дескриптор файла, не имеющий тип HMMIO, установка данного флага информирует функцию mmioClose о том, что закрывается только мультимедийный дескриптор, а не стандартный дескриптор файла.

Примечание

Функция mmioClose закрывает файл, открытый функцией mmioOpen.

Описание данной функции содержится в файле заголовка mmsystem.h. При работе с данной функцией следует включить в проект библиотеку winmm.lib.

MmioCreateChunk

MMRESULT mmioCreateChunk( HMMIO hmmio, LPMMCKINFO lpck, UINT wFlags );

Возвращаемое значение

В случае успешного завершения возвращает значение MMSYSERR_NOERROR. В противном случае возвращаемое значение может принимать одно из следующих значений:

• MMIOERR_CANNOTSEEK — невозможно определить смещение области данных вложенного блока.

• MMIOERR_CANNOTWRITE — заголовок буфера не может быть записан на диск.

Аргументы

0. hmmio — дескриптор открытого файла формата RIFF.

1. lpck — указатель на определённый в приложении объект структуры MMCKINFO, содержащий информацию о создаваемом вложенном блоке.

2. wFlags — флаги, определяющие режим создания вложенного блока. Определены следующие значения.

• MMIO_CREATELIST — создаётся вложенный блок LIST.

• MMIO_CREATERIFF — создаётся вложенный блок RIFF.

Примечание

Функция mmioCreateChunk создаёт вложенный блок в мультимедийном файле формата RIFF, открытом функцией mmioOpen. После создания нового блока текущая позиция файла располагается на начале его области данных.

Данная функция не может вставить блок в середину файла. Если приложение создаёт новый блок не в конце файла, функция mmioCreateChunk переписывает текущее содержимое файла.

Передаваемый в аргументе lpck объект структуры MMCKINFO должен быть заполнен следующим образом:

• В переменную ckid заносится идентификатор вложенного блока. Если в аргументе wFlags установлен флаг MMIO_CREATERIFF или MMIO_CREATELIST, то данная переменная заполняется функцией mmioCreateChunk.

• В переменную cksize заносится размер области данных вложенного блока в байтах, включает в себя идентификатор типа данных (если таковой имеется). Переданное в данной переменной значение может быть скорректировано при вызове функции mmioAscend.

• В переменную fccType заносится идентификатор типа данных блока RIFF, или идентификатор типа списка блока LIST. Если создаваемый вложенный блок не является блоком RIFF или LIST, то данную переменную можно не заполнять.

• Переменная dwDataOffset не нуждается в инициализации. Функция mmioCreateChunk заносит в неё смещение области данных создаваемого вложенного блока от начала файла.

• Переменная dwFlags не нуждается в инициализации. Функция mmioCreateChunk устанавливает в ней флаг MMIO_DIRTY.

Описание данной функции содержится в файле заголовка mmsystem.h. При работе с данной функцией следует включить в проект библиотеку winmm.lib.