Método IWICProgressiveLevelControl::GetLevelCount (wincodec.h)

Obtém o número de níveis de decodificação progressiva compatíveis com o CODEC.

Sintaxe

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

Parâmetros

[out, retval] pcLevels

Tipo: UINT*

Indica o número de níveis compatíveis com o CODEC.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Os usuários não devem usar essa função para iterar por meio dos níveis progressivos de uma imagem JPEG progressiva. Os níveis progressivos do JPEG são determinados pela imagem e não têm uma contagem de nível fixa. O uso desse método forçará o aplicativo a aguardar que todos os níveis progressivos sejam baixados antes que ele possa retornar. Em vez disso, os aplicativos devem usar o código a seguir para iterar por meio dos níveis progressivos de uma imagem JPEG progressiva.

Exemplos

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();
}

Requisitos

Cliente mínimo com suporte	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	wincodec.h
DLL	Windowscodecs.dll

Confira também

IWICProgressiveLevelControl

Visão geral da decodificação progressiva