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 |