Metode CBaseReferenceClock.AdviseTime
[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 AdviseTime
membuat permintaan saran satu bidikan. Metode ini mengimplementasikan metode IReferenceClock::AdviseTime .
Sintaks
HRESULT AdviseTime(
REFERENCE_TIME baseTime,
REFERENCE_TIME streamTime,
HEVENT hEvent,
DWORD_PTR *pdwAdviseToken
);
Parameter
-
baseTime
-
Waktu referensi dasar, dalam 100 unit nanodetik.
-
streamTime
-
Streaming waktu offset, dalam 100 unit nanodetik.
-
hEvent
-
Tangani ke peristiwa, dibuat oleh pemanggil.
-
pdwAdviseToken
-
Penunjuk ke variabel yang menerima pengidentifikasi untuk permintaan saran.
Nilai kembali
Mengembalikan salah satu nilai HRESULT yang diperlihatkan dalam tabel berikut ini.
Menampilkan kode | Deskripsi |
---|---|
|
Berhasil |
|
Nilai waktu tidak valid |
|
Kegagalan |
|
Argumen penunjuk NULL |
Keterangan
Metode ini membuat permintaan saran satu bidikan untuk waktu referensi baseTime + streamTime. Jumlah harus lebih besar dari nol dan kurang dari MAX_TIME, atau metode mengembalikan E_INVALIDARG. Pada waktu yang diminta, jam menandakan peristiwa yang ditentukan dalam parameter hEvent .
Untuk membatalkan pemberitahuan sebelum waktu tercapai, panggil metode CBaseReferenceClock::Unadvise dan lewati nilai pdwAdviseToken yang dikembalikan dari panggilan ini. Setelah pemberitahuan terjadi, jam secara otomatis menghapusnya, sehingga tidak perlu memanggil Unadvise. Namun, itu bukan kesalahan untuk melakukannya.
Persyaratan
Persyaratan | Nilai |
---|---|
Header |
|
Pustaka |
|