Функция acmStreamUnprepareHeader (msacm.h)

  • Статья

Функция acmStreamUnprepareHeader очищает подготовку, выполняемую функцией acmStreamPrepareHeader для потока ACM. Эта функция должна вызываться после завершения ACM с заданными буферами. Приложение должно вызвать эту функцию перед освобождением исходного и целевого буферов.

Синтаксис

MMRESULT ACMAPI acmStreamUnprepareHeader(
  HACMSTREAM        has,
  LPACMSTREAMHEADER pash,
  DWORD             fdwUnprepare
);

Параметры

has

Дескриптор для преобразования пара.

pash

Указатель на структуру ACMSTREAMHEADER , которая определяет исходный и целевой буферы, к которым необходимо выполнить неподготовку.

fdwUnprepare

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

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

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

Код возврата Описание
ACMERR_BUSY
 Заголовок потока, указанный в pash , в настоящее время используется и не может быть неподготовлен.
ACMERR_UNPREPARED
 Заголовок потока, указанный в pash , в настоящее время не подготовлен функцией acmStreamPrepareHeader .
MMSYSERR_INVALFLAG
 По крайней мере один флаг недопустим.
MMSYSERR_INVALHANDLE
 Указанный дескриптор недопустим.
MMSYSERR_INVALPARAM
 По крайней мере один параметр недопустим.

Комментарии

Неподготовка заголовка потока, который уже был неподготовлен, является ошибкой. Приложение должно указать длину исходного и целевого буферов (cbSrcLength и cbDstLength соответственно), которые использовались во время вызова соответствующего acmStreamPrepareHeader. Сбой сброса этих значений элементов приведет к сбою acmStreamUnprepareHeader с ошибкой MMSYSERR_INVALPARAM.

ACM может восстановиться после некоторых ошибок. ACM вернет ненулевое сообщение об ошибке, но заголовок потока будет должным образом неподготовлен. Чтобы определить, был ли заголовок потока на самом деле неподготовлен, приложение может проверить флаг ACMSTREAMHEADER_STATUSF_PREPARED. Если acmStreamUnprepareHeader возвращает успешное выполнение, заголовок всегда будет неподготовлен.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header msacm.h
Библиотека Msacm32.lib
DLL Msacm32.dll

См. также раздел

Функции сжатия звука

Диспетчер сжатия аудио