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

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

Синтаксис

MMRESULT ACMAPI acmStreamPrepareHeader(
  HACMSTREAM        has,
  LPACMSTREAMHEADER pash,
  DWORD             fdwPrepare
);

Параметры

has

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

pash

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

fdwPrepare

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

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

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

Код возврата Описание
MMSYSERR_INVALFLAG
По крайней мере один флаг недопустим.
MMSYSERR_INVALHANDLE
Указанный дескриптор недопустим.
MMSYSERR_INVALPARAM
По крайней мере один параметр недопустим.
MMSYSERR_NOMEM
Системе не удается выделить ресурсы.

Комментарии

Подготовка уже подготовленного заголовка потока не оказывает никакого влияния, и функция возвращает ноль. Тем не менее следует убедиться, что приложение не подготавливает заголовок потока несколько раз.

Требования

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

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

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

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