Metode IReferenceClockTimerControl::SetDefaultTimerResolution (strmif.h)

[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 SetDefaultTimerResolution menetapkan resolusi timer minimum.

Sintaks

HRESULT SetDefaultTimerResolution(
  [in] REFERENCE_TIME timerResolution
);

Parameter

[in] timerResolution

Resolusi timer minimum, dalam 100 unit nanodetik. Jika nilainya nol, jam referensi membatalkan permintaan sebelumnya.

Mengembalikan nilai

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

Menampilkan kode	Deskripsi
S_OK	Berhasil.

Keterangan

Jam referensi mencoba mengatur periode timer ke timerResolution. Periode aktual timer mungkin berbeda, tergantung pada perangkat keras. Untuk menemukan resolusi timer minimum dan maksimum, panggil fungsi timeGetDevCaps . Jam referensi mengatur resolusi timer diatur dengan memanggil timeBeginPeriod. Jika timerResolution adalah 0, metode membatalkan permintaan timer sebelumnya dengan memanggil timeEndPeriod. (Ketika jam referensi dihancurkan, secara otomatis membatalkan permintaan sebelumnya.)

Jika metode ini tidak dipanggil, jam referensi mengatur resolusi timer menjadi 1 milidetik. Untuk mendapatkan performa manajemen daya terbaik, disarankan agar Anda memanggil metode ini dengan nilai nol. Ini mengambil alih pengaturan default jam 1 milidetik. Jika ada filter dalam grafik yang memerlukan resolusi timer yang lebih tinggi, filter dapat memanggil timeBeginPeriod satu per satu. Biasanya hanya perender yang memerlukan resolusi timer tertentu.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	strmif.h (termasuk Dshow.h)
Pustaka	Strmiids.lib

Lihat juga

Kode Kesalahan dan Keberhasilan

Antarmuka IReferenceClockTimerControl