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 |