AVISTREAMINFOW-Struktur (vfw.h)

Artikel
08/27/2023

Die AVISTREAMINFO-Struktur enthält Informationen für einen einzelnen Stream.

Syntax

typedef struct _AVISTREAMINFOW {
  DWORD fccType;
  DWORD fccHandler;
  DWORD dwFlags;
  DWORD dwCaps;
  WORD  wPriority;
  WORD  wLanguage;
  DWORD dwScale;
  DWORD dwRate;
  DWORD dwStart;
  DWORD dwLength;
  DWORD dwInitialFrames;
  DWORD dwSuggestedBufferSize;
  DWORD dwQuality;
  DWORD dwSampleSize;
  RECT  rcFrame;
  DWORD dwEditCount;
  DWORD dwFormatChangeCount;
  WCHAR szName[64];
} AVISTREAMINFOW, *LPAVISTREAMINFOW;

Member

fccType

Vierzeichencode, der den Streamtyp angibt. Die folgenden Konstanten wurden für die Daten definiert, die häufig in AVI-Streams gefunden werden:

Dauerhaft	BESCHREIBUNG
streamtypeAUDIO	Gibt einen Audiostream an.
streamtypeMIDI	Gibt einen MIDI-Stream an.
streamtypeTEXT	Gibt einen Textstream an.
streamtypeVIDEO	Gibt einen Videostream an.

fccHandler

Vierzeichencode des Kompressorhandlers, der diesen Videodatenstrom komprimiert, wenn er gespeichert wird (z. B . mmioFOURCC ('M','S','V','C')). Dieses Element wird nicht für Audiodatenströme verwendet.

dwFlags

Anwendbare Flags für den Stream. Die Bits im Wort mit hoher Reihenfolge dieser Flags sind spezifisch für den Typ der daten, die im Stream enthalten sind. Die folgenden Flags werden definiert:

Name	BESCHREIBUNG
AVISTREAMINFO_DISABLED	Gibt an, dass dieser Stream gerendert werden soll, wenn er vom Benutzer explizit aktiviert wird.
AVISTREAMINFO_FORMATCHANGES	Gibt an, dass dieser Videostream Palettenänderungen enthält. Dieses Flag warnt die Wiedergabesoftware, dass sie zum Animieren der Palette benötigt wird.

dwCaps

Funktionsflags; derzeit nicht verwendet.

wPriority

Priorität des Streams.

wLanguage

Sprache des Streams.

dwScale

Zeitskala, die für den Stream gilt. Die Aufteilung von dwRate durch dwScale gibt die Wiedergaberate in der Anzahl der Samples pro Sekunde an.

Bei Videostreams sollte diese Rate die Bildfrequenz sein. Bei Audiostreams sollte diese Rate der Audioblockgröße ( nBlockAlign-Member der WAVEFORMAT - oder PCMWAVEFORMAT-Struktur ) entsprechen, die für PCM (Pulse Code Modulation) audio auf die Samplerate reduziert wird.

dwRate

Rate im Ganzzahlformat. Um die Rate in Stichproben pro Sekunde zu erhalten, dividieren Sie diesen Wert durch den Wert in dwScale.

dwStart

Beispielnummer des ersten Frames der AVI-Datei. Die Einheiten werden durch dwRate und dwScale definiert. Normalerweise ist dies 0, aber es kann eine Verzögerungszeit für einen Stream angeben, der nicht gleichzeitig mit der Datei gestartet wird.

Die Version 1.0 der AVI-Tools unterstützt keine startfreie Zeit.

dwLength

Länge dieses Datenstroms. Die Einheiten werden durch dwRate und dwScale definiert.

dwInitialFrames

Audioschiefe. Dieses Element gibt an, wie weit die Audiodaten vor den Videoframes in verschachtelten Dateien verzerrt werden sollen. In der Regel beträgt dies etwa 0,75 Sekunden.

dwSuggestedBufferSize

Empfohlene Puffergröße in Bytes für den Stream. In der Regel enthält dieses Element einen Wert, der dem größten Teil des Datenstroms entspricht. Wenn Sie die richtige Puffergröße verwenden, wird die Wiedergabe effizienter. Verwenden Sie null, wenn Sie die richtige Puffergröße nicht kennen.

dwQuality

Qualitätsindikator der Videodaten im Stream. Qualität wird als Zahl zwischen 0 und 10.000 dargestellt. Bei komprimierten Daten stellt dies in der Regel den Wert des Qualitätsparameters dar, der an die Komprimierungssoftware übergeben wird. Wenn auf –1 festgelegt ist, verwenden Treiber den Standardwert.

dwSampleSize

Größe eines einzelnen Datenbeispiels in Bytes. Wenn der Wert dieses Members 0 ist, können die Beispiele in der Größe variieren, und jedes Datenbeispiel (z. B. ein Videoframe) muss sich in einem separaten Block befinden. Ein Nonzero-Wert gibt an, dass mehrere Datenbeispiele in einem einzelnen Block innerhalb der Datei gruppiert werden können.

Bei Videostreams ist diese Zahl in der Regel 0, obwohl sie nicht zero sein kann, wenn alle Videoframes dieselbe Größe haben. Bei Audiostreams sollte diese Zahl mit dem nBlockAlign-Member der WAVEFORMAT - oder WAVEFORMATEX-Struktur identisch sein, die das Audio beschreibt.

rcFrame

Abmessungen des Videozielrechtecks. Die Werte stellen die Koordinaten der oberen linken Ecke, die Höhe und die Breite des Rechtecks dar.

dwEditCount

Die Anzahl der Bearbeitungen des Streams. Der Streamhandler verwaltet diese Anzahl.

dwFormatChangeCount

Die Anzahl der Änderungen am Streamformat. Der Streamhandler verwaltet diese Anzahl.

szName[64]

Null-beendete Zeichenfolge, die eine Beschreibung des Streams enthält.

Hinweise

Hinweis

Der vfw.h-Header definiert AVISTREAMINFO 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 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