Compartir a través de

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

  • Artículo

Obtiene el número de niveles de descodificación progresiva admitidos por el CODEC.

Sintaxis

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

Parámetros

[out, retval] pcLevels

Tipo: UINT*

Indica el número de niveles admitidos por el CODEC.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Los usuarios no deben usar esta función para recorrer en iteración los niveles progresivos de una imagen JPEG progresiva. Los niveles progresivos JPEG vienen determinados por la imagen y no tienen un recuento fijo de niveles. El uso de este método obligará a la aplicación a esperar a que se descarguen todos los niveles progresivos antes de que pueda devolverse. En su lugar, las aplicaciones deben usar el código siguiente para recorrer en iteración los niveles progresivos de una imagen JPEG progresiva.

Ejemplos

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 compatible Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado wincodec.h
Archivo DLL Windowscodecs.dll

Consulte también

IWICProgressiveLevelControl

Introducción a la descodificación progresiva