ICDrawBegin-Funktion (vfw.h)

Die ICDrawBegin-Funktion initialisiert den Renderer und bereitet das Zeichnungsziel für das Zeichnen vor.

Syntax

DWORD VFWAPIV ICDrawBegin(
  HIC                hic,
  DWORD              dwFlags,
  HPALETTE           hpal,
  HWND               hwnd,
  HDC                hdc,
  int                xDst,
  int                yDst,
  int                dxDst,
  int                dyDst,
  LPBITMAPINFOHEADER lpbi,
  int                xSrc,
  int                ySrc,
  int                dxSrc,
  int                dySrc,
  DWORD              dwRate,
  DWORD              dwScale
);

Parameter

hic

Handle mit dem zu verwendenden Dekomprimierungsor.

dwFlags

Dekomprimierungsflags. Die folgenden Werte werden definiert.

Wert	Bedeutung
ICDRAW_ANIMATE	Die Anwendung kann die Palette animieren.
ICDRAW_CONTINUE	Zeichnen ist eine Fortsetzung des vorherigen Frames.
ICDRAW_FULLSCREEN	Zeichnet die dekomprimierten Daten im Vollbildmodus.
ICDRAW_HDC	Zeichnet die dekomprimierten Daten in ein Fenster oder einen DC.
ICDRAW_MEMORYDC	DC befindet sich außerhalb des Bildschirms.
ICDRAW_QUERY	Bestimmt, ob der Dekomprimierungsor die Daten dekomprimieren kann. Der Treiber dekomprimieren die Daten nicht.
ICDRAW_UPDATING	Der aktuelle Frame wird aktualisiert und nicht wiedergegeben.

hpal

Handle für die Palette, die zum Zeichnen verwendet wird.

hwnd

Handle mit dem Fenster, das zum Zeichnen verwendet wird.

hdc

DC, der zum Zeichnen verwendet wird.

xDst

Die x-Koordinate der oberen rechten Ecke des Zielrechtecks.

yDst

Die y-Koordinate der oberen rechten Ecke des Zielrechtecks.

dxDst

Breite des Zielrechtecks.

dyDst

Höhe des Zielrechtecks.

lpbi

Zeiger auf eine BITMAPINFOHEADER-Struktur , die das Format der zu dekomprimierten Eingabedaten enthält.

xSrc

Die x-Koordinate der oberen rechten Ecke des Quellrechtecks.

ySrc

Die y-Koordinate der oberen rechten Ecke des Quellrechtecks.

dxSrc

Breite des Quellrechtecks.

dySrc

Höhe des Quellrechtecks.

dwRate

Zähler der Bildfrequenz. Die Bildfrequenz in Frames pro Sekunde wird durch Dividieren von dwRate durch dwScale abgerufen.

dwScale

Nenner der Bildfrequenz. Die Bildfrequenz in Frames pro Sekunde wird durch Dividieren von dwRate durch dwScale abgerufen.

Rückgabewert

Gibt ICERR_OK zurück, wenn der Renderer die Daten dekomprimieren oder andernfalls ICERR_UNSUPPORTED kann.

Hinweise

Die flags ICDRAW_HDC und ICDRAW_FULLSCREEN schließen sich gegenseitig aus. Wenn eine Anwendung das ICDRAW_HDC-Flag in dwFlags festlegt, verwendet der Dekomprimierungsor hwnd, hdc und die Parameter, die das Zielrechteck definieren (xDst, yDst, dxDst und dyDst).. Ihre Anwendung sollte diese Parameter auf die Größe des Zielrechtecks festlegen. Geben Sie zielrechteckswerte relativ zum aktuellen Fenster oder DC an.

Wenn eine Anwendung das ICDRAW_FULLSCREEN-Flag in dwFlags festlegt, werden die Parameter hwnd und hdc nicht verwendet und sollten auf NULL festgelegt werden. Außerdem wird das Zielrechteck nicht verwendet, und seine Parameter können auf 0 festgelegt werden.

Das Quellrechteck ist relativ zum vollständigen Videoframe. Der durch das Quellrechteck angegebene Teil des Videoframes wird gestreckt oder verkleinert, um dem Zielrechteck zu entsprechen.

Die Parameter dwRate und dwScale geben die Dekomprimierungsrate an. Der für dwRate angegebene ganzzahlige Wert dividiert durch den für dwScale angegebenen ganzzahligen Wert definiert die Bildrate in Frames pro Sekunde. Dieser Wert wird vom Renderer verwendet, wenn er für das Timing von Frames während der Wiedergabe verantwortlich ist.

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