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

Weitere Informationen

Benutzerdefinierte Datei- und Streamhandlerschnittstellen

Benutzerdefinierte Datei- und Streamhandler