Metode IVMRImagePresenter::P resentImage (strmif.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 PresentImage ini dipanggil tepat pada saat bingkai video ini harus disajikan.
Sintaks
HRESULT PresentImage(
[in] DWORD_PTR dwUserID,
[in] VMRPRESENTATIONINFO *lpPresInfo
);
Parameter
[in] dwUserID
DWORD_PTR yang ditentukan aplikasi yang secara unik mengidentifikasi instans VMR ini dalam skenario ketika beberapa instans VMR digunakan dengan satu instans Alokator-Penyaji. Lihat Keterangan
[in] lpPresInfo
Menentukan struktur VMRPRESENTATIONINFO .
Nilai kembali
Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kode kesalahan akan dikembalikan.
Keterangan
PresentImage dapat dipanggil saat filter dalam status berjalan atau dijeda. StartPresenting dan StopPresenting hanya dapat dipanggil dalam keadaan berjalan. Oleh karena itu, jika grafik dijeda sebelum dijalankan, PresentImage akan dipanggil sebelum StartPresenting.
Aplikasi dapat membuat efek campuran kustom dengan menggunakan satu instans Allocator-Presenter dengan beberapa instans VMR baik dalam satu grafik filter atau dalam beberapa grafik filter. Menggunakan penyaji alokator dengan cara ini memungkinkan aplikasi untuk memadukan aliran dari grafik filter yang berbeda, atau memadukan aliran yang berbeda dalam grafik filter yang sama. Jika Anda menggunakan satu instans VMR, atur nilai ini ke nol.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows XP dengan SP1 [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | strmif.h (termasuk Dshow.h) |
| Pustaka | Strmiids.lib |