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

Article
08/27/2023

Obtient le nombre de niveaux de décodage progressif pris en charge par le CODEC.

Syntaxe

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

Paramètres

[out, retval] pcLevels

Type : UINT*

Indique le nombre de niveaux pris en charge par le CODEC.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Les utilisateurs ne doivent pas utiliser cette fonction pour itérer dans les niveaux progressifs d’une image JPEG progressive. Les niveaux progressifs JPEG sont déterminés par l’image et n’ont pas de nombre de niveaux fixes. L’utilisation de cette méthode force l’application à attendre que tous les niveaux progressifs soient téléchargés avant de pouvoir retourner. Au lieu de cela, les applications doivent utiliser le code suivant pour itérer à travers les niveaux progressifs d’une image JPEG progressive.

Exemples

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

Configuration requise


Client minimal pris en charge	Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Mise à jour de plateforme pour Windows Server 2008 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	wincodec.h
DLL	Windowscodecs.dll

Voir aussi

IWICProgressiveLevelControl

Vue d’ensemble du décodage progressif

Partager via