IVideoFrameStep::Metode langkah (strmif.h)

  • Artikel

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Tangkapan 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 Audio/Video Capture 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 Step menyebabkan grafik filter melangkah maju menurut jumlah bingkai yang ditentukan.

Sintaks

HRESULT Step(
  DWORD    dwFrames,
  IUnknown *pStepObject
);

Parameter

dwFrames

Menentukan jumlah bingkai yang akan dilewati. Jika dwFrame adalah 1, grafik akan maju satu bingkai. Jika dwFrame adalah angka n lebih besar dari 1, grafik melompati n - 1 bingkai dan menunjukkan bingkai nth.

pStepObject

Penunjuk ke antarmuka pada filter yang akan mengontrol operasi melangkah, atau NULL. Tentukan NULL untuk melakukan langkah bingkai menggunakan filter perender dalam grafik. Jika non-NULL, objek harus mengimplementasikan antarmuka IKsPropertySet dan mendukung properti AM_KSPROPSETID_FrameStep. (Untuk informasi selengkapnya, lihat Set Properti Langkah Bingkai.) Jika grafik menyertakan filter kustom yang mengimplementasikan langkah bingkai, pStepObject dapat menentukan penunjuk ke filter tersebut.

Mengembalikan nilai

Mengembalikan HRESULT. Nilai yang mungkin termasuk yang berikut ini.

Menampilkan kode Deskripsi
S_OK
 Berhasil.
VFW_E_FRAME_STEP_UNSUPPORTED
 Langkah bingkai tidak didukung.
E_INVALIDARG
 Parameter pStepObject tidak valid.

Keterangan

Ketika operasi langkah selesai, metode ini mengirimkan pemberitahuan peristiwa EC_STEP_COMPLETE ke manajer grafik filter, yang akan meneruskannya ke perulangan peristiwa aplikasi dan mengatur grafik filter ke status dijeda.

Bingkai melangkah secara real time, yang berarti bahwa jika film diputar pada 30 bingkai per detik, memanggil IVideoFrameStep::Step dengan dwFrames diatur ke 60 akan memakan waktu 2 detik untuk dieksekusi. Semua metode dalam antarmuka ini tidak sinkron, sehingga kontrol segera kembali ke aplikasi.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [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

Lihat juga

Kode Kesalahan dan Keberhasilan

Antarmuka IVideoFrameStep