Struktur CAPTUREPARMS (vfw.h)

Artikel
03/15/2023

Struktur CAPTUREPARMS berisi parameter yang mengontrol proses pengambilan video streaming. Struktur ini digunakan untuk mendapatkan dan mengatur parameter yang memengaruhi tingkat penangkapan, jumlah buffer yang akan digunakan saat menangkap, dan bagaimana pengambilan dihentikan.

Sintaks

typedef struct tagCaptureParms {
  DWORD dwRequestMicroSecPerFrame;
  BOOL  fMakeUserHitOKToCapture;
  UINT  wPercentDropForError;
  BOOL  fYield;
  DWORD dwIndexSize;
  UINT  wChunkGranularity;
  BOOL  fUsingDOSMemory;
  UINT  wNumVideoRequested;
  BOOL  fCaptureAudio;
  UINT  wNumAudioRequested;
  UINT  vKeyAbort;
  BOOL  fAbortLeftMouse;
  BOOL  fAbortRightMouse;
  BOOL  fLimitEnabled;
  UINT  wTimeLimit;
  BOOL  fMCIControl;
  BOOL  fStepMCIDevice;
  DWORD dwMCIStartTime;
  DWORD dwMCIStopTime;
  BOOL  fStepCaptureAt2x;
  UINT  wStepCaptureAverageFrames;
  DWORD dwAudioBufferSize;
  BOOL  fDisableWriteCache;
  UINT  AVStreamMaster;
} CAPTUREPARMS, *PCAPTUREPARMS, *LPCAPTUREPARMS;

Anggota

dwRequestMicroSecPerFrame

Kecepatan bingkai yang diminta, dalam mikro detik. Nilai defaultnya adalah 66667, yang sesuai dengan 15 bingkai per detik.

fMakeUserHitOKToCapture

Bendera pengambilan yang dimulai pengguna. Jika anggota ini TRUE, AVICap menampilkan kotak dialog yang meminta pengguna untuk memulai pengambilan. Nilai defaultnya adalah FALSE.

wPercentDropForError

Persentase maksimum yang diperbolehkan dari bingkai yang dihilangkan selama pengambilan. Nilai berkisar dari 0 hingga 100. Nilai defaultnya adalah 10.

fYield

Bendera hasil. Jika anggota ini TRUE, jendela pengambilan menghasilkan utas latar belakang terpisah untuk melakukan langkah dan pengambilan streaming. Nilai defaultnya adalah FALSE.

Aplikasi yang mengatur bendera ini harus menangani potensi masalah masuk kembali karena kontrol dalam aplikasi tidak dinonaktifkan saat pengambilan sedang berlangsung.

dwIndexSize

Jumlah maksimum entri indeks dalam file AVI. Nilai berkisar dari 1800 hingga 324.000. Jika diatur ke 0, nilai default 34.952 (bingkai 32K ditambah jumlah buffer audio proporsional) digunakan.

Setiap bingkai video atau buffer data waveform-audio menggunakan satu entri indeks. Nilai entri ini menetapkan batas jumlah bingkai atau buffer audio yang dapat diambil.

wChunkGranularity

Ukuran blok logis, dalam byte, dari file AVI. Nilai 0 menunjukkan ukuran sektor saat ini digunakan sebagai granularitas.

fUsingDOSMemory

Tidak digunakan dalam aplikasi Win32.

wNumVideoRequested

Jumlah maksimum buffer video yang akan dialokasikan. Area memori untuk menempatkan buffer ditentukan dengan fUsingDOSMemory. Jumlah buffer aktual yang dialokasikan mungkin lebih rendah jika memori tidak tersedia.

fCaptureAudio

Mengambil bendera audio. Jika anggota ini TRUE, audio diambil selama pengambilan streaming. Ini adalah nilai default jika perangkat keras audio diinstal.

wNumAudioRequested

Jumlah maksimum buffer audio yang akan dialokasikan. Jumlah maksimum buffer adalah 10.

vKeyAbort

Keycode virtual yang digunakan untuk menghentikan pengambilan streaming. Nilai defaultnya adalah VK_ESCAPE. Anda harus memanggil fungsi RegisterHotKey sebelum menentukan penekanan tombol yang dapat membatalkan sesi pengambilan.

Anda dapat menggabungkan keycode yang menyertakan penekanan tombol CTRL dan SHIFT dengan menggunakan operator OR logis dengan kode kunci untuk CTRL (0x8000) dan SHIFT (0x4000).

fAbortLeftMouse

Batalkan bendera untuk tombol mouse kiri. Jika anggota ini TRUE, pengambilan streaming berhenti jika tombol mouse kiri ditekan. Nilai defaultnya adalah TRUE.

fAbortRightMouse

Batalkan bendera untuk tombol kanan mouse. Jika anggota ini TRUE, pengambilan streaming berhenti jika tombol kanan mouse ditekan. Nilai defaultnya adalah TRUE.

fLimitEnabled

Bendera yang diaktifkan batas waktu. Jika anggota ini TRUE, pengambilan streaming berhenti setelah jumlah detik dalam wTimeLimit telah berlalu. Nilai defaultnya adalah FALSE.

wTimeLimit

Batas waktu untuk pengambilan, dalam detik. Parameter ini hanya digunakan jika fLimitEnabled adalah TRUE.

fMCIControl

Bendera pengambilan perangkat MCI. Jika anggota ini TRUE, AVICap mengontrol sumber video yang kompatibel dengan MCI selama pengambilan streaming. Sumber video yang kompatibel dengan MCI termasuk VCR dan laserdisc.

fStepMCIDevice

Bendera pengambilan langkah perangkat MCI. Jika anggota ini TRUE, pengambilan langkah menggunakan perangkat MCI sebagai sumber video diaktifkan. Jika FALSE, pengambilan real time menggunakan perangkat MCI diaktifkan. (Jika fMCIControlFALSE, anggota ini diabaikan.)

dwMCIStartTime

Posisi awal, dalam milidetik, perangkat MCI untuk urutan pengambilan. (Jika fMCIControlFALSE, anggota ini diabaikan.)

dwMCIStopTime

Posisi berhenti, dalam milidetik, perangkat MCI untuk urutan pengambilan. Ketika posisi dalam konten ini tercapai, pengambilan berakhir dan perangkat MCI berhenti. (Jika fMCIControlFALSE, anggota ini diabaikan.)

fStepCaptureAt2x

Bendera pengambilan langkah resolusi ganda. Jika anggota ini TRUE, perangkat keras penangkapan mengambil dua kali resolusi yang ditentukan. (Resolusi untuk tinggi dan lebar digandakan.)

Aktifkan opsi ini jika perangkat keras tidak mendukung kompresi berbasis perangkat keras dan Anda menangkap dalam format RGB.

wStepCaptureAverageFrames

Frekuensi bingkai diambil sampelnya saat membuat bingkai berdasarkan sampel rata-rata. Nilai umum untuk jumlah rata-rata adalah 5.

dwAudioBufferSize

Ukuran buffer audio. Jika nilai default nol digunakan, ukuran setiap buffer akan menjadi maksimum 0,5 detik audio atau 10K byte.

fDisableWriteCache

Tidak digunakan dalam aplikasi Win32.

AVStreamMaster

Menunjukkan apakah aliran audio mengontrol jam saat menulis file AVI. Jika anggota ini diatur ke AVSTREAMMASTER_AUDIO, aliran audio dianggap sebagai aliran master dan durasi streaming video dipaksa untuk mencocokkan durasi audio. Jika anggota ini diatur ke AVSTREAMMASTER_NONE, durasi aliran audio dan video dapat berbeda.

Keterangan

Pesan WM_CAP_GET_SEQUENCE_SETUP atau makro capCaptureGetSetup digunakan untuk mengambil parameter pengambilan saat ini. Pesan WM_CAP_SET_SEQUENCE_SETUP atau makro capCaptureSetSetup digunakan untuk mengatur parameter pengambilan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	vfw.h