ICLocate-Funktion (vfw.h)

Die ICLocate-Funktion findet einen Kompressor oder Dekomprimierungsor, der Bilder mit den angegebenen Formaten verarbeiten kann, oder findet einen Treiber, der ein Image mit einem angegebenen Format direkt auf die Hardware dekomprimieren kann.

Syntax

HIC VFWAPI ICLocate(
  DWORD              fccType,
  DWORD              fccHandler,
  LPBITMAPINFOHEADER lpbiIn,
  LPBITMAPINFOHEADER lpbiOut,
  WORD               wFlags
);

Parameter

fccType

Vierzeichencode, der den Typ des zu öffnenden Kompressors oder Dekomprimierungstyps angibt. Für Videostreams ist der Wert dieses Parameters "VIDC".

fccHandler

Bevorzugter Handler des angegebenen Typs. In der Regel wird der Handlertyp im Streamheader in einer AVI-Datei gespeichert. Geben Sie NULL an, wenn Ihre Anwendung einen beliebigen Handlertyp verwenden kann oder den zu verwendenden Handlertyp nicht kennt.

lpbiIn

Zeiger auf eine BITMAPINFOHEADER-Struktur , die das Eingabeformat definiert. Ein Kompressorhandle wird nur zurückgegeben, wenn er dieses Format unterstützt.

lpbiOut

Zeiger auf eine BITMAPINFOHEADER-Struktur , die ein optionales dekomprimiertes Format definiert. Sie können auch null angeben, um das dem Eingabeformat zugeordnete Standardausgabeformat zu verwenden.

Wenn dieser Parameter nichtzero ist, wird ein Kompressorhandle nur zurückgegeben, wenn dieses Ausgabeformat erstellt werden kann.

wFlags

Flags, die die Suchkriterien für einen Kompressor oder Dekomprimierungsvorgang beschreiben. Die folgenden Werte werden definiert:

Wert	Bedeutung
ICMODE_COMPRESS	Sucht einen Kompressor, der ein Bild mit einem von lpbiIn definierten Format in das von lpbiOut definierte Format komprimieren kann.
ICMODE_DECOMPRESS	Sucht einen Dekomprimierungsor, der ein Bild mit einem von lpbiIn definierten Format in das von lpbiOut definierte Format dekomprimieren kann.
ICMODE_DRAW	Sucht einen Dekomprimierungsor, der ein Image mit einem durch lpbiIn definierten Format dekomprimieren und direkt auf die Hardware zeichnen kann.
ICMODE_FASTCOMPRESS	Hat die gleiche Bedeutung wie ICMODE_COMPRESS außer dass der Kompressor für einen Echtzeitbetrieb verwendet wird und die Geschwindigkeit gegenüber der Qualität betont.
ICMODE_FASTDECOMPRESS	Hat die gleiche Bedeutung wie ICMODE_DECOMPRESS außer dass der Dekomprimor für einen Echtzeitbetrieb verwendet wird und die Geschwindigkeit gegenüber der Qualität betont.

Rückgabewert

Gibt einen Handle an einen Kompressor oder Dekomprimierungsschalter zurück, wenn der Vorgang erfolgreich war oder andernfalls null.

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