AVISTREAMINFOA-Struktur (vfw.h)
Die AVISTREAMINFO-Struktur enthält Informationen für einen einzelnen Stream.
Syntax
typedef struct _AVISTREAMINFOA {
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;
char szName[64];
} AVISTREAMINFOA, *LPAVISTREAMINFOA;
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 |
|---|---|
|
Gibt einen Audiostream an. |
|
Gibt einen MIDI-Stream an. |
|
Gibt einen Textstream an. |
|
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:
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
| 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 |