AVIFileOpen

[funkcja] Otwiera/tworzy plik *.avi.

Składnia

#include <vfw.h>

STDAPI AVIFileOpen(
PAVIFILE * ppfile,
LPCTSTR szFile,
UINT mode,
CLSID pclsidHandler
);

Argumenty

Argument	Opis
ppfile	Wskaźnik na bufor, który będzie zawierał wskaźnik do interfejsu IAVIFile
szFile	Ścieżka do pliku
mode	Tryb otwarcia pliku. Trybem domyślnym jest OF_READ. Ten argument może zawierać następujące wartości: OF_CREATE Tworzy nowy plik. Jeśli plik istnieje, jego długość jest obcinana do zera. OF_PARSE Pomija wykonywanie czasochłonnych operacji, takich jak ustawianie indeksu. Należy ustawić tę flagę, jeśli nie mamy zamiaru odczytywać pliku, a chcemy jedynie sprawdzić np. właściwości pliku. Funkcja zwróci wartość tak szybko, jak to tylko możliwe. OF_READ Otwiera plik tylko do odczytu. OF_READWRITE Otwiera plik do odczytu i zapisu. OF_SHARE_DENY_NONE Otwiera plik, pozwalając innym procesom otwierać plik do odczytu i zapisu. Jeżeli inny proces otworzył plik w trybie zgodności, otworzenie pliku nie powiedzie się. OF_SHARE_DENY_READ Otwiera plik, pozwalając innym procesom otwierać plik tylko do zapisu. Jeżeli inny proces otworzył plik w trybie zgodności, otworzenie pliku nie powiedzie się. OF_SHARE_DENY_WRITE Otwiera plik, pozwalając innym procesom otwierać plik tylko do odczytu. Jeżeli inny proces otworzył plik w trybie zgodności, otworzenie pliku nie powiedzie się. OF_SHARE_EXCLUSIVE Otwiera plik, nie pozwalając innym procesom otwierać plik do odczytu i zapisu. Jeżeli plik został otwarty przez inny proces, funkcja zwróci kod błędu. OF_WRITE Otwiera plik tylko do zapisu.
pclsidHandler	Wskaźnik na klasę identyfikującą standard lub własny uchwyt, który chcesz użyć. Może być NULL

Zwracana wartość

Funkcja zwraca 0, jeśli jej działanie zakończyło się sukcesem, lub jedną z następujących wartości w przeciwnym wypadku:

Zwrócony kod	Opis
AVIERR_BADFORMAT	Plik nie może być otworzony, format pliku jest nieobsługiwany
AVIERR_MEMORY	Plik nie może być otworzony, ponieważ brakuje pamięci
AVIERR_FILEREAD	Wystąpił błąd dysku podczas czytania pliku
AVIERR_FiLEOPEN	Wystąpił błąd dysku podczas otwierania pliku
REGDB_E_CLASSNOTREG	Zgodnie z rejestrem, typ pliku podany w `AVIFileOpen` nie posiada uchwytu do kontynuowania

Opis szczegółowy

Funkcja AVIFileOpen otwiera/tworzy plik *.avi. Przed jej wywołaniem należy wywołać funkcję AVIFileInit.

IAVIFile * pfile;
AVIFileInit();
HRESULT hr = AVIFileOpen( & pfile, "plik.avi", OF_WRITE | OF_CREATE, NULL );

//Zwalniamy pamięć

AVIFileRelease( pfile );
AVIFileExit();

Wymagania

Minimalny obsługiwany klient	Windows 2000 Professional
Minimalny obsługiwany serwer	Windows 2000 Server
Nagłówek	Vfh.h
Biblioteka	Vfw32.lib
DLL	Avifil32.dll
Nazwy Unicode i ANSI	AVIFileOpenW (Unicode) i AVIFileOpenA (ANSI)

Zagadnienia powiązane

AVIFileRelease	Zmniejsza wartość licznika odwołań do pliku *.avi. (funkcja)

Linki zewnętrzne

http://msdn.microsoft.com/en-us/library/windows/desktop/dd756800(v=vs.85).aspx

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.

Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.