IReferenceClock::Metode AdviseTime (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 ini AdviseTime membuat permintaan saran satu bidikan.

Sintaks

HRESULT AdviseTime(
  [in]  REFERENCE_TIME baseTime,
  [in]  REFERENCE_TIME streamTime,
  [in]  HEVENT         hEvent,
  [out] DWORD_PTR      *pdwAdviseCookie
);

Parameter

[in] baseTime

Waktu referensi dasar, dalam unit 100 nanodetik. Lihat Keterangan.

[in] streamTime

Stream waktu offset, dalam unit 100 nanodetik. Lihat Keterangan.

[in] hEvent

Menangani ke peristiwa, yang dibuat oleh pemanggil.

[out] pdwAdviseCookie

Penunjuk ke variabel yang menerima pengidentifikasi untuk permintaan saran.

Nilai kembali

Mengembalikan nilai HRESULT . Nilai yang mungkin termasuk yang berikut ini.

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

Keterangan

Metode ini membuat permintaan saran satu bidikan untuk waktu referensi rtBaseTime + rtStreamTime. Jumlah harus lebih besar dari nol dan kurang dari MAX_TIME, atau metode mengembalikan E_INVALIDARG. Pada waktu yang diminta, jam memberi sinyal peristiwa yang ditentukan dalam parameter hEvent .

Untuk membatalkan pemberitahuan sebelum waktu tercapai, panggil metode Unadvise dan berikan nilai pdwAdviseToken yang dikembalikan dari panggilan ini. Setelah pemberitahuan terjadi, jam secara otomatis menghapusnya, sehingga tidak perlu memanggil Tidak Diawasi. Namun, itu bukan kesalahan untuk melakukannya.

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	strmif.h (termasuk Dshow.h)
Pustaka	Strmiids.lib

Lihat juga

Kode Kesalahan dan Keberhasilan

Antarmuka IReferenceClock