Поделиться через

Функция mmioCreateChunk (mmiscapi.h)

  • Статья

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

Синтаксис

MMRESULT mmioCreateChunk(
  HMMIO      hmmio,
  LPMMCKINFO pmmcki,
  UINT       fuCreate
);

Параметры

hmmio

Дескриптор открытого RIFF-файла.

pmmcki

Указатель на буфер, который получает структуру MMCKINFO , содержащую сведения о создаваемом фрагменте.

fuCreate

Флаги, определяющие тип создаваемого фрагмента. Определены следующие значения.

Значение Значение
MMIO_CREATELIST Блок "LIST".
MMIO_CREATERIFF Фрагмент RIFF.

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

Возвращает MMSYSERR_NOERROR в случае успешного выполнения или ошибку в противном случае. Возможные значения ошибок:

Код возврата Описание
MMIOERR_CANNOTSEEK
 Не удалось определить смещение части фрагмента данных.
MMIOERR_CANNOTWRITE
 Не удалось записать заголовок блока.

Комментарии

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

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

  • Элемент ckid указывает идентификатор блока. Если wFlags включает MMIO_CREATERIFF или MMIO_CREATELIST, этот элемент будет заполнен mmioCreateChunk.
  • Элемент cksize указывает размер части данных блока, включая тип формы или тип списка (если таковой есть). Если это значение неверно при вызове функции mmioAscend для пометки конца блока, mmioAscend исправляет размер блока.
  • Элемент fccType указывает тип формы или типа списка, если блок является "RIFF" или "LIST". Если блок не является фрагментом "RIFF" или "LIST", этот элемент не нужно заполнять.
  • Элемент dwDataOffset заполнять не нужно. Функция mmioCreateChunk заполняет этот элемент смещением файла части данных блока.
  • Заполнять член dwFlags не нужно. Функция mmioCreateChunk задает флаг MMIO_DIRTY в dwFlags.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header mmiscapi.h (включая Mmiscapi.h, Windows.h)
Библиотека Winmm.lib
DLL Winmm.dll