Metode CBaseControlWindow.GetMaxIdealImageSize

  • 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 ini GetMaxIdealImageSize mengambil ukuran gambar ideal maksimum.

Sintaks

HRESULT GetMaxIdealImageSize(
   long *pWidth,
   long *pHeight
);

Parameter

pWidth

Penunjuk ke lebar ideal maksimum, dalam piksel.

pHeight

Arahkan ke tinggi ideal maksimum, dalam piksel.

Nilai kembali

Mengembalikan nilai HRESULT .

Keterangan

Berbagai perender memiliki batasan performa pada ukuran gambar yang dapat ditampilkan. Meskipun masih harus berfungsi dengan baik ketika diminta untuk menampilkan gambar yang lebih besar dari maksimum yang ditentukan, perender dapat mencalonkan ukuran ideal minimum dan maksimum melalui antarmuka IVideoWindow . Antarmuka ini hanya dapat dipanggil ketika grafik filter dijeda atau berjalan, karena tidak sampai saat itu sumber daya dialokasikan dan perender dapat mengenali batasannya. Jika tidak ada batasan, perender mengisi parameter pWidth dan pHeight dengan dimensi video asli dan mengembalikan S_FALSE. Jika pembatasan ada, lebar dan tinggi terbatas dimasukkan, dan fungsi anggota mengembalikan S_OK.

Dimensi berlaku untuk ukuran video tujuan dan bukan untuk ukuran jendela keseluruhan. Jadi, saat menghitung ukuran jendela yang akan diatur, perhitungkan gaya jendela saat ini (misalnya, WS_CAPTION dan WS_BORDER).

Persyaratan

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

Lihat juga

Kelas CBaseControlWindow