Метод IWICProgressiveLevelControl::GetLevelCount (wincodec.h)

Статья
03/15/2023

Возвращает количество уровней прогрессивного декодирования, поддерживаемых CODEC.

Синтаксис

HRESULT GetLevelCount(
  [out, retval] UINT *pcLevels
);

Параметры

[out, retval] pcLevels

Тип: UINT*

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

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

Тип: HRESULT

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

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

Примеры

IWICProgressiveLevelControl *pProgressive = NULL;

HRESULT hr = (pBitmapFrame->QueryInterface(
   IID_IWICProgressiveLevelControl, 
   (void**) &pProgressive));
                
if (SUCCEEDED(hr))
{
   for (UINT uCurrentLevel = 0; SUCCEEDED(hr); uCurrentLevel++)
   {
      hr = pProgressive->SetCurrentLevel(uCurrentLevel);
      if (WINCODEC_ERR_INVALIDPROGRESSIVELEVEL == hr)
      {
         // No more levels
         break;
      }

      if (SUCCEEDED(hr))
      {
         // Output the current level
         hr = pBitmapFrame->CopyPixels(...);
      }                      
   }
}

if (pProgressive)
{
   pProgressive->Release();
}

Требования


Минимальная версия клиента	Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновлением платформы для Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	wincodec.h
DLL	Windowscodecs.dll

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

IWICProgressiveLevelControl

Общие сведения о прогрессивном декодировании

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