AVIStreamOpenFromFileA-Funktion (vfw.h)
Die funktion AVIStreamOpenFromFile öffnet einen einzelnen Datenstrom aus einer Datei.
Syntax
HRESULT AVIStreamOpenFromFileA(
PAVISTREAM *ppavi,
LPCSTR szFile,
DWORD fccType,
LONG lParam,
UINT mode,
CLSID *pclsidHandler
);
Parameter
ppavi
Zeigen Sie 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 Datenstroms angibt. Null gibt an, dass jeder Datenstrom geöffnet werden kann. Die folgenden Definitionen gelten für die Daten, die häufig in AVI-Datenströmen zu finden sind:
| Wert | Beschreibung |
|---|---|
| streamtypeAUDIO | Gibt einen Audiodatenstrom an. |
| streamtypeMIDI | Gibt einen MIDI-Stream an. |
| streamtypeTEXT | Gibt einen Textstrom an. |
| streamtypeVIDEO | Gibt einen Videostream an. |
lParam
Stream des typs, der in fccType für den Zugriff angegeben ist. Dieser Parameter ist nullbasiert; verwenden Sie Null, um das erste Vorkommen anzugeben.
mode
Access-Modus, der beim Öffnen der Datei verwendet werden soll. Diese Funktion kann nur vorhandene Datenströme öffnen, sodass das OF_CREATE Modusflagge nicht verwendet werden kann. Weitere Informationen zu den verfügbaren Flags für den Modus Parameter finden Sie in der OpenFile--Funktion.
pclsidHandler
Zeigen Sie auf einen Klassenbezeichner des Handlers, den Sie verwenden möchten. Wenn der Wert NULL-ist, wählt das System eine aus der Registrierung basierend auf der Dateierweiterung oder dem Datei-RIFF-Typ aus.
Rückgabewert
Gibt Null zurück, wenn dies erfolgreich ist oder andernfalls ein Fehler auftritt.
Bemerkungen
Diese Funktion ruft die funktionen AVIFileOpen, AVIFileGetStreamund AVIFileRelease auf.
Anmerkung
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 |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | vfw.h |
| Library | Vfw32.lib |
| DLL- | Avifil32.dll |