Compartilhar via


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