Panel użytkownika
Nazwa użytkownika:
Hasło:
Nie masz jeszcze konta?
Hasło nie zostało zweryfikowane
Niniejsze hasło zostało opracowane, jednak nie zostało ono zweryfikowane przez administrację serwisu. Jeżeli znalazłeś błędy merytoryczne w niniejszym dokumencie, prosimy o ich zgłoszenie na forum w dziale Znalezione błędy.
Opracował: xevuel
Biblioteki C/C++

AVIFileOpen

[funkcja] Otwiera/tworzy plik *.avi.

Składnia

C/C++
#include <vfw.h>

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

Argumenty

ArgumentOpis
ppfileWskaźnik na bufor, który będzie zawierał wskaźnik do interfejsu IAVIFile
szFileŚcieżka do pliku
modeTryb 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.

pclsidHandlerWskaź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 kodOpis
AVIERR_BADFORMATPlik nie może być otworzony, format pliku jest nieobsługiwany
AVIERR_MEMORYPlik nie może być otworzony, ponieważ brakuje pamięci
AVIERR_FILEREADWystąpił błąd dysku podczas czytania pliku
AVIERR_FiLEOPENWystąpił błąd dysku podczas otwierania pliku
REGDB_E_CLASSNOTREGZgodnie 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.
C/C++
IAVIFile * pfile;
AVIFileInit();
HRESULT hr = AVIFileOpen( & pfile, "plik.avi", OF_WRITE | OF_CREATE, NULL );

//Zwalniamy pamięć

AVIFileRelease( pfile );
AVIFileExit();

Wymagania

Minimalny obsługiwany klientWindows 2000 Professional
Minimalny obsługiwany serwerWindows 2000 Server
NagłówekVfh.h
BibliotekaVfw32.lib
DLLAvifil32.dll
Nazwy Unicode i ANSIAVIFileOpenW (Unicode) i AVIFileOpenA (ANSI)

Zagadnienia powiązane

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

Linki zewnętrzne