Metode IVideoWindow::GetMaxIdealImageSize (control.h)
[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 untuk gambar video.
Sintaks
HRESULT GetMaxIdealImageSize(
[out] long *pWidth,
[out] long *pHeight
);
Parameter
[out] pWidth
Menerima lebar ideal maksimum, dalam piksel.
[out] pHeight
Menerima tinggi ideal maksimum, dalam piksel.
Nilai kembali
Nilai yang mungkin dikembalikan meliputi yang berikut ini:
| Menampilkan kode | Deskripsi |
|---|---|
|
Penunjuk NULL . |
|
Tidak dapat mengambil ukuran gambar maksimum. |
|
Berhasil. |
|
Filter dihentikan. |
Keterangan
Ukuran ideal maksimum mungkin berbeda dari ukuran video asli, karena perangkat keras video mungkin memiliki persyaratan peregangan tertentu.
Metode ini mengembalikan S_FALSE dalam berbagai keadaan:
- Filter menggunakan transportasi IOverlay .
- Mode UseWhenFullScreen aktif. (Lihat IDirectDrawVideo::UseWhenFullScreen.)
- Permukaan video tidak memiliki peregangan overlay maksimum. (Anggota dwMaxOverlayStretch dari struktur DDCAPS adalah nol. Lihat IDirectDrawVideo::GetCaps.)
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | control.h (termasuk Dshow.h) |
| Pustaka | Strmiids.lib |