Метод Image::GetEncoderParameterList (gdiplusheaders.h)

Статья
02/26/2024

Метод Image::GetEncoderParameterList получает список параметров, поддерживаемых указанным кодировщиком изображений.

Синтаксис

Status GetEncoderParameterList(
  [in]  const CLSID       *clsidEncoder,
  [in]  UINT              size,
  [out] EncoderParameters *buffer
);

Параметры

[in] clsidEncoder

Тип: const CLSID*

Указатель на ИДЕНТИФИКАТОР CLSID , указывающий кодировщик.

[in] size

Тип: UINT

Целое число, указывающее размер буферного массива в байтах. Вызовите метод Image::GetEncoderParameterListSize , чтобы получить необходимый размер.

[out] buffer

Тип: EncoderParameters*

Указатель на объект EncoderParameters , который получает список поддерживаемых параметров.

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

Тип: Состояние

В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .

Если метод завершается сбоем, он возвращает один из других элементов перечисления Status .

Метод Image::GetEncoderParameterList возвращает массив объектов EncoderParameter . Перед вызовом Image::GetEncoderParameterList необходимо выделить буфер, достаточно большой для получения этого массива, который является частью объекта EncoderParameters . Можно вызвать метод Image::GetEncoderParameterListSize , чтобы получить размер необходимого объекта EncoderParameters в байтах .

Требования

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