METODE IMFClockStateSink::OnClockStart (mfidl.h)

  • Artikel

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

Lihat juga

IMFClockStateSink

MFTIME

Jam Presentasi