AVIFILEINFOW-Struktur (vfw.h)

Die AVIFILEINFO-Struktur enthält globale Informationen für eine gesamte AVI-Datei.

Syntax

typedef struct _AVIFILEINFOW {
  DWORD dwMaxBytesPerSec;
  DWORD dwFlags;
  DWORD dwCaps;
  DWORD dwStreams;
  DWORD dwSuggestedBufferSize;
  DWORD dwWidth;
  DWORD dwHeight;
  DWORD dwScale;
  DWORD dwRate;
  DWORD dwLength;
  DWORD dwEditCount;
  WCHAR szFileType[64];
} AVIFILEINFOW, *LPAVIFILEINFOW;

Member

dwMaxBytesPerSec

Ungefähre maximale Datenrate der AVI-Datei.

dwFlags

Ein bitweises OR mit 0 oder mehr Flags. Die folgenden Flags sind definiert:

Name	BESCHREIBUNG
AVIFILEINFO_HASINDEX	Die AVI-Datei enthält einen Index am Ende der Datei. Um eine gute Leistung zu erzielen, sollten alle AVI-Dateien einen Index enthalten.
AVIFILEINFO_MUSTUSEINDEX	Der Dateiindex enthält die Wiedergabereihenfolge für die Blöcke in der Datei. Verwenden Sie beim Wiedergeben der Daten den Index anstelle der physischen Reihenfolge der Blöcke. Dies kann zum Erstellen einer Liste von Frames für die Bearbeitung verwendet werden.
AVIFILEINFO_ISINTERLEAVED	Die AVI-Datei ist verschachtelt.
AVIFILEINFO_WASCAPTUREFILE	Die AVI-Datei ist eine speziell zugeordnete Datei, die zum Aufzeichnen von Echtzeitvideos verwendet wird. Anwendungen sollten den Benutzer warnen, bevor sie eine Datei mit diesem Flag überschreiben, da der Benutzer diese Datei wahrscheinlich defragmentiert hat.
AVIFILEINFO_COPYRIGHTED	Die AVI-Datei enthält urheberrechtlich geschützte Daten und Software. Wenn dieses Flag verwendet wird, sollte die Software nicht zulassen, dass die Daten dupliziert werden.

dwCaps

Funktionsflags. Die folgenden Flags sind definiert:

Name	BESCHREIBUNG
AVIFILECAPS_CANREAD	Eine Anwendung kann die AVI-Datei mit der Leseberechtigung öffnen.
AVIFILECAPS_CANWRITE	Eine Anwendung kann die AVI-Datei mit der Schreibberechtigung öffnen.
AVIFILECAPS_ALLKEYFRAMES	Jeder Frame in der AVI-Datei ist ein Keyframe.
AVIFILECAPS_NOCOMPRESSION	Die AVI-Datei verwendet keine Komprimierungsmethode.

dwStreams

Anzahl der Streams in der Datei. Beispielsweise enthält eine Datei mit Audio und Video mindestens zwei Streams.

dwSuggestedBufferSize

Empfohlene Puffergröße in Bytes zum Lesen der Datei. Im Allgemeinen sollte diese Größe groß genug sein, um den größten Block in der Datei zu enthalten. Bei einer verschachtelten Datei sollte diese Größe groß genug sein, um einen ganzen Datensatz und nicht nur einen Block zu lesen.

Wenn die Puffergröße zu klein ist oder auf 0 festgelegt ist, muss die Wiedergabesoftware den Speicher während der Wiedergabe neu zuweisungen, wodurch die Leistung verringert wird.

dwWidth

Breite der AVI-Datei in Pixel.

dwHeight

Höhe der AVI-Datei in Pixel.

dwScale

Zeitskala, die für die gesamte Datei gilt. Unter Dividieren von dwRate durch dwScale wird die Anzahl der Stichproben pro Sekunde angegeben.

Jeder Stream kann eine eigene Zeitskala definieren, um die Dateizeitskala abzulösen.

dwRate

Rate in einem ganzzahligen Format. Um die Rate in Stichproben pro Sekunde zu erhalten, dividieren Sie diesen Wert durch den Wert in dwScale.

dwLength

Länge der AVI-Datei. Die Einheiten werden durch dwRate und dwScale definiert.

dwEditCount

Anzahl der Streams, die der AVI-Datei hinzugefügt oder daraus gelöscht wurden.

szFileType[64]

Null-beendete Zeichenfolge, die beschreibende Informationen für den Dateityp enthält.

Hinweise

Hinweis

Der vfw.h-Header definiert AVIFILEINFO als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	vfw.h

Weitere Informationen

AVIFile-Funktionen und -Makros

AVIFile-Strukturen