Share via

Metode CBaseControlVideo.GetDestinationPosition

  • Artikel

[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.]

Metode mengambil GetDestinationPosition persegi tujuan dalam satu operasi atomik.

Sintaks

HRESULT GetDestinationPosition(
   long *pLeft,
   long *pTop,
   long *pWidth,
   long *pHeight
);

Parameter

pLeft

Penunjuk ke koordinat kiri persegi panjang tujuan.

pTop

Arahkan ke koordinat atas persegi tujuan.

pWidth

Penunjuk ke lebar persegi tujuan.

pHeight

Arahkan kursor ke ketinggian persegi tujuan.

Nilai kembali

Mengembalikan nilai HRESULT yang bergantung pada implementasi; bisa menjadi salah satu nilai berikut, atau nilai lain yang tidak tercantum.

Menampilkan kode Deskripsi
E_FAIL
 Kegagalan.
E_POINTER
 Argumen pointer NULL.
VFW_E_NOT_CONNECTED
 Operasi tidak dapat dilakukan karena pin tidak tersambung.
NOERROR
 Berhasil.

Keterangan

Fungsi anggota ini dapat digunakan sebagai pengganti panggilan terpisah ke fungsi CBaseControlVideo::get_DestinationLeft, CBaseControlVideo::get_DestinationTop, CBaseControlVideo::get_DestinationWidth, dan CBaseControlVideo::get_DestinationHeight . Aplikasi dapat mengubah persegi panjang sumber dan tujuan untuk video melalui antarmuka IBasicVideo . Persegi panjang sumber memengaruhi bagian mana dari sumber video asli yang akan muncul di layar; persegi panjang tujuan memengaruhi tempat video akan muncul saat diputar. Persegi panjang tujuan relatif terhadap area klien jendela tempatnya diputar. Sudut kiri atas jendela berkoordinasi (0,0).

Persyaratan

Persyaratan Nilai
Header
Ctlutil.h (termasuk Streams.h)
Pustaka
Strmbase.lib (build ritel);
Strmbasd.lib (build debug)

Lihat juga

Kelas CBaseControlVideo