METODE IMFClockStateSink::OnClockStart (mfidl.h)
Dipanggil ketika jam presentasi dimulai.
Sintaks
HRESULT OnClockStart(
[in] MFTIME hnsSystemTime,
[in] LONGLONG llClockStartOffset
);
Parameter
[in] hnsSystemTime
Waktu sistem ketika jam dimulai, dalam unit 100-nanodetik.
[in] llClockStartOffset
Waktu mulai baru untuk jam, dalam unit 100 nanodetik. Parameter ini juga dapat sama dengan PRESENTATION_CURRENT_POSITION, menunjukkan jam telah dimulai atau dimulai ulang dari posisinya saat ini.
Menampilkan nilai
Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Metode ini dipanggil ketika metode IMFPresentationClock::Start jam presentasi dipanggil, dengan pengecualian berikut: Jika jam dijeda dan Mulai dipanggil dengan nilai PRESENTATION_CURRENT_POSITION, IMFClockStateSink::OnClockRestart dipanggil alih-alih OnClockStart.
Jam memberi tahu sumber waktu presentasi dengan memanggil metode OnClockStart sumber waktu. Panggilan ini terjadi secara sinkron dalam metode Mulai . Jika sumber waktu mengembalikan kesalahan dari OnClockStart, metode Mulai jam presentasi mengembalikan kesalahan dan perubahan status tidak terjadi.
Untuk objek apa pun yang bukan sumber waktu presentasi, metode OnClockStart disebut secara asinkron, setelah perubahan status selesai. Dalam hal ini, nilai pengembalian dari metode ini diabaikan.
Nilai yang diberikan dalam llClockStartOffset adalah waktu presentasi ketika jam dimulai, sehingga relatif terhadap awal presentasi. Sink media tidak boleh merender data apa pun dengan waktu presentasi lebih awal dari llClockStartOffSet. Jika sampel mengalihkan offset—yaitu, jika offset berada di antara waktu mulai dan berhenti sampel—sink harus memangkas sampel sehingga hanya data setelah llClockStartOffset yang dirender, atau hanya menghilangkan sampel.
Persyaratan
| Klien minimum yang didukung | Windows Vista [aplikasi desktop | Aplikasi UWP] |
| Server minimum yang didukung | Windows Server 2008 [aplikasi desktop | Aplikasi UWP] |
| Target Platform | Windows |
| Header | mfidl.h |
| Pustaka | Mfuuid.lib |