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
| Unterstützte Mindestversion (Client) | Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wincodec.h |
| DLL | Windowscodecs.dll |