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


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

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

Синтаксис

HRESULT GetFileExtensions(
  [in]      UINT  cchFileExtensions,
  [in, out] WCHAR *wzFileExtensions,
  [in, out] UINT  *pcchActual
);

Параметры

[in] cchFileExtensions

Тип: UINT

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

[in, out] wzFileExtensions

Тип: WCHAR*

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

[in, out] pcchActual

Тип: UINT*

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

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

Тип: HRESULT

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

Комментарии

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

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

Требования

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