Struktur CAPTUREPARMS (vfw.h)

Struktur CAPTUREPARMS berisi parameter yang mengontrol proses pengambilan video streaming. Struktur ini digunakan untuk mendapatkan dan mengatur parameter yang memengaruhi tingkat pengambilan, 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 mikrostik. 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 diizinkan dari bingkai yang dihilangkan selama pengambilan. Nilai berkisar dari 0 hingga 100. Nilai defaultnya adalah 10.

fYield

Bendera hasil. Jika anggota ini TRUE, jendela tangkapan 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 untuk 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

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

Anda dapat menggabungkan kode kunci 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 akan berhenti jika tombol kiri mouse ditekan. Nilai defaultnya adalah TRUE.

fAbortRightMouse

Batalkan bendera untuk tombol kanan mouse. Jika anggota ini TRUE, pengambilan streaming akan 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 mencakup 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, dari perangkat MCI untuk urutan pengambilan. (Jika fMCIControlFALSE, anggota ini diabaikan.)

dwMCIStopTime

Posisi berhenti, dalam milidetik, dari 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 tangkap mengambil dua kali resolusi yang ditentukan. (Resolusi untuk tinggi dan lebar digandakan.)

Aktifkan opsi ini jika perangkat keras tidak mendukung desimalasi 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 streaming audio dan video dapat berbeda.

Keterangan

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

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

Persyaratan

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

Lihat juga

RegisterHotKey

Pengambilan Video

Struktur Pengambilan Video

WM_CAP_GET_SEQUENCE_SETUP

WM_CAP_SET_SEQUENCE_SETUP

capCaptureGetSetup

capCaptureSetSetup