Fungsi AVISaveVA (vfw.h)

Artikel
11/20/2024

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

Sintaksis

HRESULT AVISaveVA(
  LPCSTR               szFile,
  CLSID                *pclsidHandler,
  AVISAVECALLBACK      lpfnCallback,
  int                  nStreams,
  PAVISTREAM           *ppavi,
  LPAVICOMPRESSOPTIONS *plpOptions
);

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 yang digunakan untuk menampilkan informasi status dan membiarkan pengguna membatalkan operasi penyimpanan.

nStreams

Jumlah aliran yang akan disimpan.

ppavi

Penunjuk ke array pointer ke struktur fungsi AVISTREAM . Array menggunakan satu penunjuk untuk setiap aliran.

plpOptions

Penunjuk ke array pointer untuk struktur AVICOMPRESSOPTIONS. Array menggunakan satu penunjuk untuk setiap aliran.

Mengembalikan nilai

Mengembalikan AVIERR_OK jika berhasil atau kesalahan sebaliknya.

Komentar

Fungsi ini setara dengan fungsi AVISave kecuali aliran diteruskan dalam array alih-alih sebagai jumlah variabel argumen.

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 adalah array yang mengidentifikasi aliran untuk disimpan dalam file dan menentukan opsi kompresi aliran tersebut.

Aplikasi harus mengalokasikan memori untuk struktur AVICOMPRESSOPTIONS dan array pointer ke struktur ini.

Argumen ppavi berisi alamat pointer ke antarmuka IAVIStream .

Nota

Header vfw.h mendefinisikan AVISaveV 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