ICDraw-Funktion (vfw.h)

Die ICDraw-Funktion dekomprimiert ein Bild zum Zeichnen.

Syntax

DWORD VFWAPIV ICDraw(
  HIC    hic,
  DWORD  dwFlags,
  LPVOID lpFormat,
  LPVOID lpData,
  DWORD  cbData,
  LONG   lTime
);

Parameter

hic

Handle zu einem Dekomprimierungsor.

dwFlags

Dekomprimierungsflags. Die folgenden Werte werden definiert.

Wert Bedeutung
ICDRAW_HURRYUP Daten werden gepuffert und nicht auf den Bildschirm gezeichnet. Verwenden Sie dieses Flag für die schnellste Dekomprimierung.
ICDRAW_NOTKEYFRAME Der aktuelle Frame ist kein Keyframe.
ICDRAW_NULLFRAME Der aktuelle Frame enthält keine Daten, und der vorherige Frame sollte neu gezeichnet werden.
ICDRAW_PREROLL Der aktuelle Videorahmen tritt auf, bevor die Wiedergabe gestartet werden soll. Wenn die Wiedergabe beispielsweise mit Frame 10 beginnt und Frame 0 der nächste vorherige Schlüsselrahmen ist, werden die Frames 0 bis 9 mit dem ICDRAW_PREROLL-Flag an den Treiber gesendet. Der Treiber benötigt diese Daten, um Frame 10 ordnungsgemäß anzuzeigen.
ICDRAW_UPDATE Updates den Bildschirm basierend auf zuvor empfangenen Daten. Legen Sie lpData auf NULL fest, wenn dieses Flag verwendet wird.

lpFormat

Zeiger auf eine BITMAPINFOHEADER-Struktur , die das Eingabeformat der Daten enthält.

lpData

Zeiger auf die Eingabedaten.

cbData

Größe der Eingabedaten in Bytes.

lTime

Zeit in Beispielen, um diesen Frame zu zeichnen. Die Einheiten für Videodaten sind Frames. Eine Definition der Wiedergaberate finden Sie in den DwRate - und dwScale-Membern der ICDRAWBEGIN-Struktur .

Rückgabewert

Gibt ICERR_OK zurück, wenn erfolgreich oder andernfalls ein Fehler aufgetreten ist.

Hinweise

Sie können das Zeichnen der Frames initiieren, indem Sie die ICM_DRAW_START Nachricht senden (oder das MAKRO ICDrawStart verwenden). Die Anwendung sollte unbedingt die erforderliche Anzahl von Frames puffern, bevor das Zeichnen gestartet wird. Senden Sie die KM_GETBUFFERSWANTED Nachricht (oder verwenden Sie das Makro ICGetBuffersWanted ), um diesen Wert abzurufen.

Anforderungen

   
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