Kelas CBaseControlVideo
[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Pengambilan Audio/Video di Media Foundation. Fitur-fitur tersebut telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer, IMFMediaEngine , dan Pengambilan Audio/Video di Media Foundation alih-alih DirectShow, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]
Kelas CBaseControlVideo mengimplementasikan antarmuka IBasicVideo dan mengontrol properti video dari jendela video generik. Umumnya, objek CBaseControlVideo adalah perender video yang menggambar video ke dalam jendela pada layar.
Banyak fungsi anggota CBaseControlVideo hanya mengharuskan perender video terhubung ke grafik filter. Jika tidak tersambung, fungsi anggota akan mengembalikan VFW_E_NOT_CONNECTED. Properti yang diatur pada perender video bertahan antara koneksi berturut-turut dan pemutusan sambungan. Semua aplikasi harus memastikan bahwa mereka mengatur ulang properti perender sebelum memulai presentasi.
Saat bekerja dengan video, aplikasi dapat memilih sebagian video yang akan digunakan. Bagian ini adalah persegi panjang sumber yang dikontrol objek CBaseControlVideo . CBaseControlVideo memungkinkan aplikasi Anda mengatur dan mengambil persegi panjang sumber. Semua persegi panjang yang digunakan CBaseControlVideo menggunakan nilai lebar dan tinggi daripada nilai kanan dan bawah. Ketika tidak ada persegi panjang sumber yang telah diatur, properti persegi panjang sumber mengembalikan ukuran video asli penuh.
| Anggota Data Terproteksi | Deskripsi |
|---|---|
| m_pFilter | Penunjuk ke filter media pemilik. |
| m_pInterfaceLock | Bagian kritis yang ditentukan secara eksternal. |
| m_pPin | Kontrol tipe media untuk koneksi. |
| Fungsi Anggota | Deskripsi |
| CBaseControlVideo | Membuat objek CBaseControlVideo . |
| CopyImage | Membuat salinan memori gambar video. |
| GetImageSize | Mengambil informasi ukuran gambar video. |
| SetControlVideoPin | Menyetel pin yang harus disinkronkan objek ini. |
| Fungsi Anggota yang Dapat Diganti | Deskripsi |
| CheckSourceRect | Menentukan apakah persegi panjang sumber valid. |
| CheckTargetRect | Menentukan apakah persegi panjang target valid. |
| GetSourceRect | Mengambil persegi panjang video sumber saat ini (virtual murni). |
| GetStaticImage | Mengembalikan gambar saat ini dalam buffer memori (virtual murni). |
| GetTargetRect | Mengambil persegi panjang video target saat ini (virtual murni). |
| GetVideoFormat | Mengambil struktur VIDEOINFOHEADER yang berisi format video. |
| IsDefaultSourceRect | Menentukan apakah perender menggunakan persegi sumber default (virtual murni). |
| IsDefaultTargetRect | Menentukan apakah perender menggunakan persegi target default (virtual murni). |
| OnUpdateRectangles | Dipanggil saat persegi sumber atau target berubah. |
| OnVideoSizeChange | Meneruskan EC_VIDEO_SIZE_CHANGED ke aplikasi. |
| SetDefaultSourceRect | Mengatur persegi panjang video sumber default (virtual murni). |
| SetDefaultTargetRect | Mengatur persegi video target default (virtual murni). |
| SetSourceRect | Mengatur persegi video sumber saat ini (virtual murni). |
| SetTargetRect | Mengatur persegi target saat ini (virtual murni). |
| Metode IBasicVideo | Deskripsi |
| get_AvgTimePerFrame | Mengambil perkiraan waktu rata-rata per bingkai. |
| get_BitErrorRate | Mengambil perkiraan laju kesalahan bit. |
| get_BitRate | Mengambil perkiraan laju bit untuk video. |
| GetCurrentImage | Mengambil penyajian memori gambar saat ini. |
| get_DestinationHeight | Mengambil tinggi persegi panjang tujuan saat ini. |
| get_DestinationLeft | Mengambil koordinat kiri persegi panjang tujuan saat ini. |
| GetDestinationPosition | Mengambil posisi tujuan saat ini. |
| get_DestinationTop | Mengambil koordinat teratas persegi panjang tujuan saat ini. |
| get_DestinationWidth | Mengambil lebar persegi panjang tujuan saat ini. |
| get_SourceHeight | Mengambil tinggi persegi panjang sumber saat ini. |
| get_SourceLeft | Mengambil koordinat kiri persegi panjang sumber saat ini. |
| GetSourcePosition | Mengambil posisi sumber saat ini. |
| get_SourceTop | Mengambil koordinat teratas persegi panjang sumber saat ini. |
| get_SourceWidth | Mengambil lebar persegi panjang sumber saat ini. |
| get_VideoHeight | Mengambil tinggi video asli. |
| GetVideoPaletteEntries | Mengambil berbagai entri palet untuk video. |
| GetVideoSize | Mengambil lebar dan tinggi video asli. |
| get_VideoWidth | Mengambil lebar video asli. |
| IsUsingDefaultDestination | Menentukan apakah perender menggunakan jendela tujuan default. |
| IsUsingDefaultSource | Menentukan apakah perender menggunakan jendela sumber default. |
| put_DestinationHeight | Mengatur tinggi persegi tujuan. |
| put_DestinationLeft | Mengatur koordinat kiri persegi panjang tujuan. |
| put_DestinationTop | Mengatur koordinat teratas persegi panjang tujuan. |
| put_DestinationWidth | Mengatur lebar persegi tujuan. |
| put_SourceHeight | Mengatur tinggi persegi sumber. |
| put_SourceLeft | Mengatur koordinat kiri persegi panjang sumber. |
| put_SourceTop | Mengatur koordinat teratas persegi panjang sumber. |
| put_SourceWidth | Mengatur lebar persegi sumber. |
| SetDefaultDestinationPosition | Menyetel kembali posisi tujuan default. |
| SetDefaultSourcePosition | Menyetel posisi sumber default lagi. |
| SetDestinationPosition | Mengatur posisi persegi tujuan. |
| SetSourcePosition | Mengatur posisi persegi sumber. |
Lihat juga