AVIFILEINFOA-Struktur (vfw.h)

Artikel
08/27/2023

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

Syntax

typedef struct _AVIFILEINFOA {
  DWORD dwMaxBytesPerSec;
  DWORD dwFlags;
  DWORD dwCaps;
  DWORD dwStreams;
  DWORD dwSuggestedBufferSize;
  DWORD dwWidth;
  DWORD dwHeight;
  DWORD dwScale;
  DWORD dwRate;
  DWORD dwLength;
  DWORD dwEditCount;
  char  szFileType[64];
} AVIFILEINFOA, *LPAVIFILEINFOA;

Member

dwMaxBytesPerSec

Ungefähre maximale Datenrate der AVI-Datei.

dwFlags

Ein bitweiser OR mit null oder mehr Flags. Die folgenden Flags werden definiert:

Name	BESCHREIBUNG
AVIFILEINFO_HASINDEX	Die AVI-Datei hat 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 zur 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 werden definiert:

Name	BESCHREIBUNG
AVIFILECAPS_CANREAD	Eine Anwendung kann die AVI-Datei mit der Leseberechtigung öffnen.
AVIFILECAPS_CANWRITE	Eine Anwendung kann die AVI-Datei mit dem Schreibrecht ö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 verfügt eine Datei mit Audio und Video über 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 Teil der Datei zu enthalten. Bei einer verschachtelten Datei sollte diese Größe groß genug sein, um einen gesamten Datensatz und nicht nur einen Block zu lesen.

Wenn die Puffergröße zu klein ist oder auf null festgelegt ist, muss die Wiedergabesoftware während der Wiedergabe Speicher neu zuweisungen, wodurch die Leistung beeinträchtigt 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 Dividierung von dwRate durch dwScale wird die Anzahl der Stichproben pro Sekunde angegeben.

Jeder Stream kann eine eigene Zeitskala definieren, um die Dateizeitskala zu ersetzen.

dwRate

Rate im Ganzzahlformat. 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 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 automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


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

Freigeben über