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

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

  • Статья

Функция mmioAscend возрастает из фрагмента в RIFF-файле, нисходящего в с помощью функции mmioDescend или созданного с помощью функции mmioCreateChunk .

Синтаксис

MMRESULT mmioAscend(
  HMMIO      hmmio,
  LPMMCKINFO pmmcki,
  UINT       fuAscend
);

Параметры

hmmio

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

pmmcki

Указатель на определяемую приложением структуру MMCKINFO , ранее заполненную функцией mmioDescend или mmioCreateChunk .

fuAscend

Защищены; значение должно быть равно нулю.

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

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

Код возврата Описание
MMIOERR_CANNOTSEEK
 При поиске до конца блока произошла ошибка.
MMIOERR_CANNOTWRITE
 Содержимое буфера не может быть записано на диск.

Комментарии

Если кусок был сведен в с помощью mmioDescend, mmioAscend ищет место после конца блока (за дополнительным байтом панели, если таковой имеется).

Если блок был создан и спустился в с помощью mmioCreateChunk или если флаг MMIO_DIRTY установлен в элементе dwFlags структуры MMCKINFO , на которую ссылается lpck, текущая позиция файла считается конечной частью блока данных. Если размер блока отличается от значения, хранящегося в элементе cksize структуры MMCKINFO при вызове mmioCreateChunk , mmioAscend исправляет размер блока в файле, прежде чем возрастать от блока. Если размер блока нечетный, mmioAscend записывает пустой байт в конце блока. После возрастания от блока текущей позицией файла является расположение после конца блока (за дополнительным байтом панели, если таковой имеется).

Требования

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