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

  • Статья

Функция acmStreamSize возвращает рекомендуемый размер исходного или целевого буфера в потоке ACM.

Синтаксис

MMRESULT ACMAPI acmStreamSize(
  HACMSTREAM has,
  DWORD      cbInput,
  LPDWORD    pdwOutputBytes,
  DWORD      fdwSize
);

Параметры

has

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

cbInput

Размер исходного или целевого буфера в байтах. Флаги fdwSize указывают, что определяет входной параметр. Этот параметр должен быть ненулевым.

pdwOutputBytes

Указатель на переменную, содержащую размер исходного или целевого буфера в байтах. Флаги fdwSize указывают, что определяет выходной параметр. Если функция acmStreamSize завершается успешно, это расположение всегда будет заполнено ненулевым значением.

fdwSize

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

Значение Значение
ACM_STREAMSIZEF_DESTINATION Параметр cbInput содержит размер буфера назначения. Параметр pdwOutputBytes получит рекомендуемый размер исходного буфера в байтах.
ACM_STREAMSIZEF_SOURCE Параметр cbInput содержит размер исходного буфера. Параметр pdwOutputBytes получит рекомендуемый размер буфера назначения в байтах.

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

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

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

Комментарии

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

В случае ошибки расположение, на которое указывает pdwOutputBytes , будет получать ноль. При этом предполагается, что указатель, заданный pdwOutputBytes , является допустимым.

Требования

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

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

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

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