Fungsi TimeProvCommand (timeprov.h)

Artikel
03/04/2024

Fungsi panggilan balik yang dipanggil oleh manajer penyedia waktu untuk mengirim perintah ke penyedia waktu.

Sintaks

HRESULT TimeProvCommand(
  [in] TimeProvHandle hTimeProv,
  [in] TimeProvCmd    eCmd,
  [in] TimeProvArgs   pvArgs
);

Parameter

[in] hTimeProv

Handel ke penyedia waktu. Fungsi TimeProvOpen menerima handel ini.

[in] eCmd

Perintah yang akan dikirim. Parameter ini bisa menjadi salah satu nilai berikut.

Perintah	Makna
TPC_GetSamples	Penyedia waktu harus mengembalikan sampel waktu yang telah dikumpulkannya. Jika tidak ada data yang tersedia, penyedia tidak boleh mengembalikan sampel. Untuk mengetahui detail selengkapnya, harap lihat Keterangan. Parameter pvArgs adalah penunjuk ke struktur TpcGetSamplesArgs . Manajer penyedia waktu menyediakan buffer untuk sampel. Jika buffer pvArgs jika terlalu kecil, penyedia harus menyediakan sampel sebanyak mungkin dan mengembalikan ERROR_INSUFFICIENT_BUFFER. Kode kesalahan lain yang dikembalikan oleh penyedia diabaikan.
TPC_NetTopoChange	Topologi jaringan telah berubah. Penyedia jaringan harus mendeteksi ulang pengaturan jaringan dan memverifikasi bahwa mereka dapat menjangkau sumbernya. Parameter pvArgs menunjukkan apakah perubahan diminta oleh pengguna (NTC_UserRequested) atau sistem (NTC_Default).
TPC_Query	Disiapkan untuk penggunaan masa mendatang.
TPC_PollIntervalChanged	Interval polling telah berubah. Penyedia waktu harus memanggil fungsi GetTimeSysInfo untuk mengambil nilai baru. Parameter pvArgs tidak digunakan. Kesalahan apa pun yang dikembalikan oleh penyedia diabaikan.
TPC_Shutdown	Sistem sedang dimatikan. Penyedia waktu harus keluar dalam waktu lima detik. Parameter pvArgs tidak digunakan.
TPC_TimeJumped	Jam sistem disesuaikan secara mendadak, sehingga penyedia waktu harus membuang stempel kapan saja yang disimpannya. Parameter pvArgs menunjukkan apakah lompatan waktu diminta oleh pengguna (TJF_UserRequested) atau sistem (TJF_Default).
TPC_UpdateConfig	Penyedia waktu harus memverifikasi apakah data konfigurasi khusus aplikasi yang disimpan dalam registri telah berubah. Parameter pvArgs tidak digunakan. Kesalahan apa pun yang dikembalikan oleh penyedia diabaikan.

[in] pvArgs

Penunjuk ke buffer yang menentukan informasi perintah. Format data ini tergantung pada nilai eCmd.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah S_OK. Jika tidak, nilai yang dikembalikan adalah salah satu kode kesalahan yang ditentukan dalam WinError.h.

Keterangan

Penyedia waktu tidak boleh memakan waktu lebih dari setengah detik untuk kembali dari panggilan ini.

Saat memproses perintah TPC_GetSamples, penyedia harus mengembalikan satu sampel untuk setiap sumber yang dipantaunya. Oleh karena itu, penyedia perangkat keras harus mengembalikan satu sampel, sementara penyedia jaringan seperti NTP dapat mengembalikan beberapa sampel. Penyedia tidak boleh mengembalikan beberapa sampel dari satu sumber; itu harus mengembalikan sampel terbaik dari cache sampelnya untuk sumbernya. Penyedia dapat mengembalikan sampel yang sama pada panggilan berikutnya, asalkan data tidak berubah.

Contoh

Misalnya, lihat Penyedia Waktu Sampel.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	timeprov.h

Lihat juga

GetTimeSysInfoFunc

TimeProvOpen

TpcGetSamplesArgs

Bagikan melalui