Fungsi AVISaveA (vfw.h)

Artikel
11/20/2024

Fungsi AVISave membangun file dengan menggabungkan aliran data dari file lain atau dari memori.

Sintaksis

HRESULT AVISaveA(
  LPCSTR               szFile,
  CLSID                *pclsidHandler,
  AVISAVECALLBACK      lpfnCallback,
  int                  nStreams,
  PAVISTREAM           pfile,
  LPAVICOMPRESSOPTIONS lpOptions,
  ...                  
);

Parameter

szFile

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

pclsidHandler

Penunjuk ke penangan file yang digunakan untuk menulis file. File dibuat dengan memanggil fungsi AVIFileOpen menggunakan handler ini. Jika handler tidak ditentukan, default dipilih dari registri berdasarkan ekstensi file.

lpfnCallback

Penunjuk ke fungsi panggilan balik untuk operasi penyimpanan.

nStreams

Jumlah aliran yang disimpan dalam file.

pfile

Penunjuk ke aliran AVI. Parameter ini dipasangkan dengan lpOptions. Pasangan parameter dapat diulang sebagai jumlah variabel argumen.

lpOptions

Penunjuk ke struktur AVICOMPRESSOPTIONS yang ditentukan aplikasi yang berisi opsi kompresi untuk aliran yang direferensikan oleh pavi. Parameter ini dipasangkan dengan pavi. Pasangan parameter dapat diulang sebagai jumlah variabel argumen.

...

Mengembalikan nilai

Mengembalikan AVIERR_OK jika berhasil atau kesalahan sebaliknya.

Komentar

Fungsi ini membuat file, menyalin data aliran ke dalam file, menutup file, dan merilis sumber daya yang digunakan oleh file baru. Dua parameter terakhir dari fungsi ini mengidentifikasi aliran untuk disimpan dalam file dan menentukan opsi kompresi aliran tersebut. Saat menyimpan lebih dari satu aliran dalam file AVI, ulangi dua parameter khusus aliran ini untuk setiap aliran dalam file.

Fungsi panggilan balik (dirujuk dengan menggunakan lpfnCallback) dapat menampilkan informasi status dan membiarkan pengguna membatalkan operasi penyimpanan. Fungsi panggilan balik menggunakan format berikut:


LONG PASCAL SaveCallback(int nPercent)

Parameter nPercent menentukan persentase file yang disimpan.

Fungsi panggilan balik harus mengembalikan AVIERR_OK jika operasi harus dilanjutkan dan AVIERR_USERABORT jika pengguna ingin membatalkan operasi penyimpanan.

Argumen pavi adalah penunjuk ke antarmuka IAVIStream .

Nota

Header vfw.h mendefinisikan AVISave sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor 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

Bagikan melalui