ICImageCompress-Funktion (vfw.h)

  • Artikel

Die ICImageCompress-Funktion komprimiert ein Bild auf eine bestimmte Größe. Für diese Funktion sind keine Initialisierungsfunktionen erforderlich.

Syntax

HANDLE VFWAPI ICImageCompress(
  HIC          hic,
  UINT         uiFlags,
  LPBITMAPINFO lpbiIn,
  LPVOID       lpBits,
  LPBITMAPINFO lpbiOut,
  LONG         lQuality,
  LONG         *plSize
);

Parameter

hic

Griff zu einem Kompressor, der mit der ICOpen-Funktion geöffnet wird. Geben Sie NULL an, damit VCM einen geeigneten Kompressor für das Komprimierungsformat auswählt. Bei einer Anwendung kann der Benutzer den Kompressor mithilfe der ICCompressorChoose-Funktion auswählen, die den ausgewählten Kompressor öffnet und einen Handle des Kompressors in diesem Parameter zurückgibt.

uiFlags

Reserviert; muss null sein.

lpbiIn

Zeiger auf die BITMAPINFO-Struktur , die das Eingabedatenformat enthält.

lpBits

Zeiger auf Eingabedatenbits, die komprimiert werden sollen. Die Datenbits schließen Header- und Formatinformationen aus.

lpbiOut

Zeiger auf die BITMAPINFO-Struktur , die das komprimierte Ausgabeformat enthält. Geben Sie NULL an, damit der Kompressor ein geeignetes Format verwendet.

lQuality

Vom Kompressor verwendete Qualitätswert. Die Werte reichen von 0 bis 10.000.

plSize

Die maximale gewünschte Größe für das komprimierte Bild. Der Kompressor kann die Daten möglicherweise nicht komprimieren, um in diese Größe zu passen. Wenn die Funktion zurückgibt, zeigt dieser Parameter auf die Größe des komprimierten Bilds. Bildgrößen werden in Bytes angegeben.

Rückgabewert

Gibt ein Handle an einen komprimierten DIB zurück. Die Bilddaten folgen dem Formatheader.

Hinweise

Um die Formatinformationen aus der BITMAPINFOHEADER-Struktur abzurufen, verwenden Sie die GlobalLock-Funktion , um die Daten zu sperren. Verwenden Sie die GlobalFree-Funktion , um den DIB frei zu geben, wenn Sie fertig sind.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vfw.h
Bibliothek Vfw32.lib
DLL Msvfw32.dll

Weitere Informationen

Videokomprimierungsfunktionen

Videokomprimierungs-Manager