Struktur CAPSTATUS (vfw.h)

Struktur CAPSTATUS mendefinisikan status jendela pengambilan saat ini.

Sintaks

typedef struct tagCapStatus {
  UINT     uiImageWidth;
  UINT     uiImageHeight;
  BOOL     fLiveWindow;
  BOOL     fOverlayWindow;
  BOOL     fScale;
  POINT    ptScroll;
  BOOL     fUsingDefaultPalette;
  BOOL     fAudioHardware;
  BOOL     fCapFileExists;
  DWORD    dwCurrentVideoFrame;
  DWORD    dwCurrentVideoFramesDropped;
  DWORD    dwCurrentWaveSamples;
  DWORD    dwCurrentTimeElapsedMS;
  HPALETTE hPalCurrent;
  BOOL     fCapturingNow;
  DWORD    dwReturn;
  UINT     wNumVideoAllocated;
  UINT     wNumAudioAllocated;
} CAPSTATUS, *PCAPSTATUS, *LPCAPSTATUS;

Anggota

uiImageWidth

Lebar gambar, dalam piksel.

uiImageHeight

Tinggi gambar, dalam piksel

fLiveWindow

Bendera jendela langsung. Nilai anggota ini TRUE jika jendela menampilkan video menggunakan metode pratinjau.

fOverlayWindow

Bendera jendela overlay. Nilai anggota ini TRUE jika jendela menampilkan video menggunakan overlay perangkat keras.

fScale

Bendera penskalakan input. Nilai anggota ini TRUE jika jendela menskalakan video input ke area klien saat menampilkan video menggunakan pratinjau. Parameter ini tidak berpengaruh saat menampilkan video menggunakan overlay.

ptScroll

Offset x dan y dari piksel yang ditampilkan di sudut kiri atas area klien jendela.

fUsingDefaultPalette

Bendera palet default. Nilai anggota ini TRUE jika driver pengambilan menggunakan palet defaultnya.

fAudioHardware

Bendera perangkat keras audio. Nilai anggota ini TRUE jika sistem memiliki perangkat keras waveform-audio yang terinstal.

fCapFileExists

Ambil bendera file. Nilai anggota ini TRUE jika file pengambilan yang valid telah dibuat.

dwCurrentVideoFrame

Jumlah bingkai yang diproses selama pengambilan streaming saat ini (atau terbaru). Jumlah ini termasuk bingkai yang dijatuhkan.

dwCurrentVideoFramesDropped

Jumlah bingkai yang dihilangkan selama pengambilan streaming saat ini (atau terbaru). Bingkai yang dihilangkan terjadi ketika laju pengambilan melebihi laju di mana bingkai dapat disimpan ke file. Dalam hal ini, driver pengambilan tidak memiliki buffer yang tersedia untuk menyimpan data. Menghilangkan bingkai tidak memengaruhi sinkronisasi karena bingkai sebelumnya ditampilkan sebagai pengganti bingkai yang dihilangkan.

dwCurrentWaveSamples

Jumlah sampel waveform-audio yang diproses selama pengambilan streaming saat ini (atau terbaru).

dwCurrentTimeElapsedMS

Waktu, dalam milidetik, sejak awal pengambilan streaming saat ini (atau terbaru).

hPalCurrent

Tangani ke palet saat ini.

fCapturingNow

Menangkap bendera. Nilai anggota ini TRUE saat penangkapan sedang berlangsung.

dwReturn

Nilai pengembalian kesalahan. Gunakan anggota ini jika aplikasi Anda tidak mendukung fungsi panggilan balik kesalahan.

wNumVideoAllocated

Jumlah buffer video yang dialokasikan. Nilai ini mungkin kurang dari angka yang ditentukan dalam anggota wNumVideoRequested dari struktur CAPTUREPARMS .

wNumAudioAllocated

Jumlah buffer audio yang dialokasikan. Nilai ini mungkin kurang dari angka yang ditentukan dalam anggota wNumAudioRequested dari struktur CAPTUREPARMS .

Keterangan

Karena status jendela pengambilan berubah sebagai respons terhadap berbagai pesan, aplikasi harus memperbarui informasi dalam struktur ini setiap kali perlu mengaktifkan item menu, menentukan status aktual jendela pengambilan, atau memanggil kotak dialog format video. Jika aplikasi menghasilkan selama penangkapan streaming, struktur ini mengembalikan kemajuan pengambilan di anggota dwCurrentVideoFrame, dwCurrentVideoFramesDropped, dwCurrentWaveSamples, dan dwCurrentTimeElapsedMS . Gunakan pesan WM_CAP_GET_STATUS atau makro capGetStatus untuk memperbarui konten struktur ini.

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

Lihat juga

CAPTUREPARMS

Pengambilan Video

Struktur Pengambilan Video

WM_CAP_GET_STATUS