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


Метод IWICBitmapCodecInfo::GetPixelFormats (wincodec.h)

Извлекает форматы пикселей, поддерживаемые кодеком.

Синтаксис

HRESULT GetPixelFormats(
  [in]      UINT cFormats,
  [in, out] GUID *pguidPixelFormats,
  [out]     UINT *pcActual
);

Параметры

[in] cFormats

Тип: UINT

Размер массива pguidPixelFormats . Используйте при 0 первом вызове, чтобы определить необходимый размер массива.

[in, out] pguidPixelFormats

Тип: GUID*

Получает поддерживаемые форматы пикселей. Используйте при NULL первом вызове, чтобы определить необходимый размер массива.

[out] pcActual

Тип: UINT*

Размер массива, необходимый для получения всех поддерживаемых форматов пикселей.

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Шаблон использования для этого метода является процессом двух вызовов. При первом вызове извлекается размер массива, необходимый для получения всех поддерживаемых форматов пикселей, вызывая его с параметром cFormats , для которого задано значение 0 , а для pguidPixelFormats — значение NULL. Этот вызов задает для pcActual необходимый размер массива. После определения требуемого размера массива второй вызов GetPixelFormats с параметром pguidPixelFormats , заданным для массива соответствующего размера, извлекает форматы пикселей.

Требования

Требование Значение
Минимальная версия клиента Windows XP с пакетом обновления 2 (SP2), Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header wincodec.h
Библиотека Windowscodecs.lib
DLL Windowscodecs.dll