Функция ICCompressorChoose (vfw.h)

Статья
08/27/2023

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

Синтаксис

BOOL VFWAPI ICCompressorChoose(
  HWND      hwnd,
  UINT      uiFlags,
  LPVOID    pvIn,
  LPVOID    lpData,
  PCOMPVARS pc,
  LPSTR     lpszTitle
);

Параметры

hwnd

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

uiFlags

Применимые флаги. Определены следующие значения.

Значение	Значение
ICMF_CHOOSE_ALLCOMPRESSORS	Все компрессоры должны отображаться в списке выбора. Если этот флаг не указан, в списке выбора появятся только компрессоры, которые могут обрабатывать формат входных данных.
ICMF_CHOOSE_DATARATE	Отображает поле проверка и поле ввода для ввода скорости передачи данных для фильма.
ICMF_CHOOSE_KEYFRAME	Отображает поле проверка и поле ввода для ввода частоты ключевых кадров.
ICMF_CHOOSE_PREVIEW	Отображает кнопку для развертывания диалогового окна для включения окна предварительного просмотра. В окне предварительного просмотра показано, как будут отображаться кадры фильма при сжатии с текущими параметрами.

pvIn

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

lpData

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

pc

Указатель на структуру COMPVARS . Возвращаемые сведения инициализируют структуру для использования с другими функциями.

lpszTitle

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

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

Возвращает значение TRUE , если пользователь выбирает компрессор и нажимает кнопку ОК. Возвращает значение FALSE при ошибке или при нажатии пользователем клавиши ОТМЕНА.

Перед использованием этой функции задайте для элемента cbSize структуры COMPVARS размер структуры. Инициализируйте оставшуюся часть структуры нулями, если вы не хотите указать допустимые значения по умолчанию для диалогового окна. Если заданы значения по умолчанию, задайте для элемента dwFlags ICMF_COMPVARS_VALID и инициализировать другие элементы структуры. Дополнительные сведения об инициализации структуры см. в разделе Функция ICSeqCompressFrameStart и COMPVARS.

Требования

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

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

Функции сжатия видео

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

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