Fungsi AVIFileOpen (vfw.h)

Artikel
08/27/2023

Fungsi AVIFileOpen membuka file AVI dan mengembalikan alamat antarmuka file yang digunakan untuk mengaksesnya. Pustaka AVIFile mempertahankan hitungan berapa kali file dibuka, tetapi tidak berapa kali file dirilis. Gunakan fungsi AVIFileRelease untuk merilis file dan mengurangi jumlah.

Sintaks

HRESULT AVIFileOpen(
  PAVIFILE *ppfile,
  LPCSTR   szFile,
  UINT     uMode,
  LPCLSID  lpHandler
);

Parameter

ppfile

Arahkan ke buffer yang menerima penunjuk antarmuka IAVIFile baru.

szFile

String yang dihentikan null yang berisi nama file yang akan dibuka.

uMode

Mode akses yang akan digunakan saat membuka file. Mode akses default adalah OF_READ. Mode akses berikut dapat ditentukan dengan AVIFileOpen.

Nilai	Makna
OF_CREATE	Membuat file baru. Jika file sudah ada, file dipotong menjadi panjang nol.
OF_PARSE	Melewati operasi yang memakan waktu, seperti membangun indeks. Atur bendera ini jika Anda ingin fungsi kembali secepat mungkin—misalnya, jika Anda akan mengkueri properti file tetapi tidak membaca file.
OF_READ	Membuka file untuk dibaca.
OF_READWRITE	Membuka file untuk membaca dan menulis.
OF_SHARE_DENY_NONE	Membuka file secara tidak termasuk. Proses lain dapat membuka file dengan akses baca atau tulis. AVIFileOpen gagal jika proses lain telah membuka file dalam mode kompatibilitas.
OF_SHARE_DENY_READ	Membuka file secara tidak termasuk. Proses lain dapat membuka file dengan akses tulis. AVIFileOpen gagal jika proses lain telah membuka file dalam mode kompatibilitas atau memiliki akses baca ke dalamnya.
OF_SHARE_DENY_WRITE	Membuka file secara tidak termasuk. Proses lain dapat membuka file dengan akses baca. AVIFileOpen gagal jika proses lain telah membuka file dalam mode kompatibilitas atau memiliki akses tulis ke file tersebut.
OF_SHARE_EXCLUSIVE	Membuka file dan menolak proses lain akses apa pun ke file tersebut. AVIFileOpen gagal jika ada proses lain yang telah membuka file.
OF_WRITE	Membuka file untuk menulis.

lpHandler

Arahkan ke pengidentifikasi kelas dari handler standar atau kustom yang ingin Anda gunakan. Jika nilainya NULL, sistem memilih handler dari registri berdasarkan ekstensi file atau jenis RIFF yang ditentukan dalam file.

Mengembalikan nilai

Mengembalikan nol jika berhasil atau kesalahan sebaliknya. Nilai kesalahan yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
AVIERR_BADFORMAT	File tidak dapat dibaca, menunjukkan file rusak atau format yang tidak dikenali.
AVIERR_MEMORY	File tidak dapat dibuka karena memori tidak cukup.
AVIERR_FILEREAD	Terjadi kesalahan disk saat membaca file.
AVIERR_FILEOPEN	Terjadi kesalahan disk saat membuka file.
REGDB_E_CLASSNOTREG	Menurut registri, jenis file yang ditentukan dalam AVIFileOpen tidak memiliki handler untuk memprosesnya.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	vfw.h
Pustaka	Vfw32.lib
DLL	Avifil32.dll

Lihat juga

Fungsi AVIFile

Fungsi dan Makro AVIFile

AVIFileRelease

Bagikan melalui