Добавил:
Upload Опубликованный материал нарушает ваши авторские права? Сообщите нам.
Вуз: Предмет: Файл:
Func.doc
Скачиваний:
0
Добавлен:
01.05.2025
Размер:
1.58 Mб
Скачать

MmioClose

MMRESULT mmioClose( HMMIO hmmio, UINT wFlags );

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

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

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

Аргументы

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

  2. 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 — заголовок буфера не может быть записан на диск.

Аргументы

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

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

  3. 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.

Соседние файлы в предмете [НЕСОРТИРОВАННОЕ]