AVIStreamOpenFromFileA-Funktion (vfw.h)

Die FUNKTION AVIStreamOpenFromFile öffnet einen einzelnen Stream aus einer Datei.

Syntax

HRESULT AVIStreamOpenFromFileA(
  PAVISTREAM *ppavi,
  LPCSTR     szFile,
  DWORD      fccType,
  LONG       lParam,
  UINT       mode,
  CLSID      *pclsidHandler
);

Parameter

ppavi

Zeiger auf einen Puffer, der das neue Datenstromhandle empfängt.

szFile

Null-beendete Zeichenfolge, die den Namen der zu öffnenden Datei enthält.

fccType

Vierstelligen Code, der den Typ des zu öffnenden Streams angibt. Null gibt an, dass ein beliebiger Stream geöffnet werden kann. Die folgenden Definitionen gelten für die Daten, die häufig in AVI-Streams gefunden werden:

Wert BESCHREIBUNG
streamtypeAUDIO Gibt einen Audiodatenstrom an.
streamtypeMIDI Gibt einen MIDI-Stream an.
streamtypeTEXT Gibt einen Textstream an.
streamtypeVIDEO Gibt einen Videostream an.

lParam

Stream des in fccType angegebenen Typs für den Zugriff. Dieser Parameter ist nullbasiert; Verwenden Sie null, um das erste Vorkommen anzugeben.

mode

Zugriffsmodus, der beim Öffnen der Datei verwendet werden soll. Diese Funktion kann nur vorhandene Streams öffnen, sodass das OF_CREATE-Modusflag nicht verwendet werden kann. Weitere Informationen zu den verfügbaren Flags für den Modusparameter finden Sie in der OpenFile-Funktion .

pclsidHandler

Zeiger auf einen Klassenbezeichner des Handlers, den Sie verwenden möchten. Wenn der Wert NULL ist, wählt das System basierend auf der Dateierweiterung oder dem Dateityp RIFF einen wert aus der Registrierung aus.

Rückgabewert

Gibt null zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt.

Hinweise

Diese Funktion ruft die Funktionen AVIFileOpen, AVIFileGetStream und AVIFileRelease auf .

Hinweis

Der vfw.h-Header definiert AVIStreamOpenFromFile 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]
Zielplattform Windows
Kopfzeile vfw.h
Bibliothek Vfw32.lib
DLL Avifil32.dll

Weitere Informationen

AVIFile-Funktionen

AVIFile-Funktionen und -Makros