IReferenceClockTimerControl-Schnittstelle (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die IReferenceClockTimerControl Schnittstelle ändert den Zeitgeberzeitraum, der von einer Referenzuhr verwendet wird. Diese Schnittstelle wird von der DirectShow-Systemreferenzuhr verfügbar gemacht.

Vererbung

Die IReferenceClockTimerControl-Schnittstelle erbt von der IUnknown-Schnittstelle . IReferenceClockTimerControl verfügt auch über folgende Membertypen:

Methoden

Die IReferenceClockTimerControl-Schnittstelle verfügt über diese Methoden.

IReferenceClockTimerControl::GetDefaultTimerResolution Die GetDefaultTimerResolution-Methode gibt die Timerauflösung zurück, die von der Referenzuhr angefordert wurde.
IReferenceClockTimerControl::SetDefaultTimerResolution Die SetDefaultTimerResolution-Methode legt die minimale Timerauflösung fest.

Hinweise

Standardmäßig legt die Systemverweisuhr in DirectShow den Zeitgeberzeitraum auf den vom Timer zulässigen Mindestwert fest. In der Regel ist dieser Wert 1 Millisekunde.

Der Zeitgeberzeitraum ist eine globale Einstellung in Windows. Eine höhere Auflösung kann die Genauigkeit von Timeoutintervallen in Wartefunktionen verbessern. Es kann jedoch auch die Gesamtleistung des Systems verringern, da der Threadplaner Aufgaben häufiger wechselt. Hohe Auflösungen können auch verhindern, dass das CPU-Energieverwaltungssystem in Energiesparmodi wechselt. Wenn Sie eine höhere Auflösung festlegen, wird die Genauigkeit des Leistungsindikators mit hoher Auflösung nicht verbessert.

Der Standard Zweck dieser Schnittstelle besteht darin, die Standardtimereinstellung der Referenzuhr außer Kraft zu setzen. Rufen Sie hierzu SetDefaultTimerResolution mit dem Wert 0 (null) auf. Dies kann zu einer niedrigeren Timerauflösung führen, wodurch der Computer des Benutzers in einen Energiesparmodus wechseln kann. (Das tatsächliche Verhalten hängt von vielen anderen Faktoren ab, z. B. von den ausgeführten anderen Prozessen.) Der DVD-Navigator-Filter verwendet diese Schnittstelle, wie hier beschrieben.

Wenn ein DirectShow-Filter eine höhere Timerauflösung erfordert, sollte timeBeginPeriod aufgerufen werden. In der Regel gilt diese Anforderung nur für Rendererfilter.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)