Freigeben über


AVIStreamFindSample-Funktion (vfw.h)

Die AVIStreamFindSample-Funktion gibt die Position eines Beispiels (Keyframe, nicht leerer Frame oder ein Frame, der eine Formatänderung enthält) relativ zur angegebenen Position zurück.

Diese Funktion ersetzt die veraltete AVIStreamFindKeyFrame-Funktion .

Syntax

LONG AVIStreamFindSample(
  PAVISTREAM pavi,
  LONG       lPos,
  LONG       lFlags
);

Parameter

pavi

Behandeln sie einen offenen Stream.

lPos

Startframe für die Suche.

lFlags

Flags, die den Typ des zu suchenden Frames, die Richtung im zu durchsuchenden Datenstrom und den Typ der Rückgabeinformationen angeben. Die folgenden Flags werden definiert.

Wert Bedeutung
FIND_ANY Findet einen nicht erlösenden Frame. Dieses Flag ersetzt das SEARCH_ANY-Flag.
FIND_KEY Sucht nach einem Keyframe. Dieses Flag ersetzt das SEARCH_KEY-Flag.
FIND_FORMAT Findet eine Formatänderung.
FIND_NEXT Sucht nach der nächsten Beispiel-, Frame- oder Formatänderungssuche nach vorne. Das aktuelle Beispiel ist in der Suche enthalten. Verwenden Sie dieses Flag mit dem FIND_ANY-, FIND_KEY- oder FIND_FORMAT-Flag. Dieses Flag ersetzt das SEARCH_FORWARD-Flag.
FIND_PREV Sucht nach der nächsten Stichproben-, Frame- oder Formatänderungssuche rückwärts. Das aktuelle Beispiel ist in der Suche enthalten. Verwenden Sie dieses Flag mit dem FIND_ANY-, FIND_KEY- oder FIND_FORMAT-Flag. Dieses Flag ersetzt die SEARCH_NEAREST- und SEARCH_BACKWARD-Flags.
FIND_FROM_START Sucht nach der ersten Beispiel-, Frame- oder Formatänderung ab dem Start des Datenstroms. Verwenden Sie dieses Flag mit dem FIND_ANY-, FIND_KEY- oder FIND_FORMAT-Flag.

Rückgabewert

Gibt die Position des gefundenen Frames oder -1 zurück, wenn die Suche nicht erfolgreich ist.

Hinweise

Die flags FIND_KEY, FIND_ANY und FIND_FORMAT schließen sich gegenseitig aus, ebenso die FIND_NEXT- und FIND_PREV-Flags.

Das Argument pavi enthält einen Zeiger auf eine IAVIStream-Schnittstelle .

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
DLL Avifil32.dll

Weitere Informationen

AVIFile-Funktionen

AVIFile-Funktionen und -Makros