IGetFrame::SetFormat-Methode (vfw.h)
Die SetFormat-Methode legt das dekomprimierte Bildformat der zu extrahierenden Frames fest und stellt optional einen Puffer für den Dekomprimierungsvorgang bereit.
Syntax
HRESULT SetFormat(
LPBITMAPINFOHEADER lpbi,
LPVOID lpBits,
int x,
int y,
int dx,
int dy
);
Parameter
lpbi
Zeiger auf eine BITMAPINFOHEADER-Struktur , die das dekomprimierte Bildformat definiert. Sie können auch NULL oder den Wert ((LPBITMAPINFOHEADER) 1) für diesen Parameter angeben. NULL bewirkt, dass der Dekomprimierung ein Format auswählt, das für die Bearbeitung geeignet ist (normalerweise ein 24-Bit-Bildtiefenformat). Der Wert ((LPBITMAPINFOHEADER) 1) bewirkt, dass der Dekomprimierungsor ein Format auswäht, das für den aktuellen Anzeigemodus geeignet ist.
lpBits
Zeiger auf einen Puffer, der die dekomprimierten Bilddaten enthält. Geben Sie NULL an, damit diese Methode einen Puffer zuweisen soll.
x
Die x-Koordinate des Zielrechtecks innerhalb des von lpbi angegebenen DIB. Dieser Parameter wird verwendet, wenn lpBits nicht NULL ist.
y
Die y-Koordinate des Zielrechtecks innerhalb des von lpbi angegebenen DIB. Dieser Parameter wird verwendet, wenn lpBits nicht NULL ist.
dx
Breite des Zielrechtecks. Dieser Parameter wird verwendet, wenn lpBits nicht NULL ist.
dy
Höhe des Zielrechtecks. Dieser Parameter wird verwendet, wenn lpBits nicht NULL ist.
Rückgabewert
Gibt NOERROR zurück, wenn dies erfolgreich war, E_OUTOFMEMORY , wenn das dekomprimierte Bild größer als die Puffergröße ist, oder andernfalls E_FAIL .
Hinweise
Die Parameter x, y, dx und dy identifizieren den Teil der Bitmap, die von lpbi und lpBits angegeben wird, der das dekomprimierte Bild empfängt.
Für in C++ geschriebene Handler verfügt SetFormat über die folgende Syntax:
HRESULT SetFormat(LPBITMAPINFOHEADER lpbi, LPVOID lpBits, int x,
int y, int dx, int dy);
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 |