IWICProgressiveLevelControl::GetLevelCount-Methode (wincodec.h)

Ruft die Anzahl der Stufen der progressiven Decodierung ab, die vom CODEC unterstützt werden.

Syntax

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

Parameter

[out, retval] pcLevels

Typ: UINT*

Gibt die Anzahl der vom CODEC unterstützten Ebenen an.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Benutzer sollten diese Funktion nicht verwenden, um die progressiven Ebenen eines progressiven JPEG-Bilds zu durchlaufen. Die progressiven JPEG-Ebenen werden vom Bild bestimmt und verfügen nicht über eine feste Anzahl von Ebenen. Wenn Sie diese Methode verwenden, muss die Anwendung warten, bis alle progressiven Ebenen heruntergeladen werden, bevor sie zurückgegeben werden kann. Stattdessen sollten Anwendungen den folgenden Code verwenden, um die progressiven Ebenen eines progressiven JPEG-Bilds zu durchlaufen.

Beispiele

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

Anforderungen

Weitere Informationen

IWICProgressiveLevelControl

Übersicht über die progressive Decodierung