IVideoFrameStep::Metode langkah (strmif.h)

Metode ini Step menyebabkan grafik filter melangkah maju dengan jumlah bingkai yang ditentukan.

Sintaks

HRESULT Step(
  DWORD    dwFrames,
  IUnknown *pStepObject
);

Parameter

dwFrames

Menentukan jumlah bingkai yang akan dilewati. Jika dwFrames adalah 1, grafik akan meneruskan satu bingkai. Jika dwFrames adalah angka n yang lebih besar dari 1, grafik melewati 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 Rangkaian Properti Pemangkasan Bingkai.) Jika grafik menyertakan filter kustom yang mengimplementasikan pemindahan 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

   
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