Metode CBaseReferenceClock.AdvisePeriodic

Artikel
07/28/2023

[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 AdvisePeriodic membuat permintaan saran berkala. Metode ini mengimplementasikan metode IReferenceClock::AdvisePeriodic .

Sintaks

HRESULT AdvisePeriodic(
   REFERENCE_TIME StartTime,
   REFERENCE_TIME PeriodTime,
   HSEMAPHORE     hSemaphore,
   DWORD_PTR      *pdwAdviseToken
);

Parameter

StartTime: Waktu pemberitahuan pertama, dalam unit 100 nanodetik. Harus lebih besar dari nol dan kurang dari MAX_TIME.
PeriodTime: Waktu antara pemberitahuan, dalam 100 unit nanodetik. Harus lebih besar dari nol.
hSemaphore: Tangani ke semaphore, yang dibuat oleh pemanggil.
pdwAdviseToken: Penunjuk ke variabel yang menerima pengidentifikasi untuk permintaan saran.

Mengembalikan nilai

Mengembalikan salah satu nilai HRESULT yang diperlihatkan dalam tabel berikut ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil
E_INVALIDARG	Nilai waktu tidak valid
E_OUTOFMEMORY	Kegagalan
E_POINTER	Argumen penunjuk NULL

Keterangan

Pada setiap waktu pemberitahuan, jam melepaskan semaphore yang ditentukan dalam parameter hSemaphore . Ketika tidak ada pemberitahuan lebih lanjut yang diperlukan, panggil metode CBaseReferenceClock::Unadvise dan teruskan nilai pdwAdviseToken yang dikembalikan dari panggilan ini.

Persyaratan

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

Lihat juga

Kelas CBaseReferenceClock

Bagikan melalui