Fungsi AVIFileOpenA (vfw.h)

Artikel
11/20/2024

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

Sintaksis

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

Parameter

ppfile

Pointer ke buffer yang menerima baru iaVIFile penunjuk antarmuka.

szFile

Untai (karakter) null-terminated 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	Arti
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 nonexclusively. 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 nonexclusively. Proses lain dapat membuka file dengan akses tulis. AVIFileOpen gagal jika proses lain telah membuka file dalam mode kompatibilitas atau memiliki akses baca ke file tersebut.
OF_SHARE_DENY_WRITE	Membuka file secara nonexclusively. 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 ditulis.

lpHandler

Penunjuk 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. Kemungkinan nilai kesalahan termasuk yang berikut ini.

Mengembalikan 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.

Komentar

Nota

Header vfw.h mendefinisikan AVIFileOpen sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

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

Lihat juga

Fungsi AVIFile

Fungsi dan Makro AVIFile

AVIFileRelease

Bagikan melalui