IReferenceClockTimerControl::SetDefaultTimerResolution-Methode (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 SetDefaultTimerResolution -Methode legt die minimale Timerauflösung fest.

Syntax

HRESULT SetDefaultTimerResolution(
  [in] REFERENCE_TIME timerResolution
);

Parameter

[in] timerResolution

Minimale Timerauflösung in 100 Nanosekundeneinheiten. Wenn der Wert 0 ist, bricht die Referenzuhr ihre vorherige Anforderung ab.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Hinweise

Die Referenzuhr versucht, den Zeitraum des Timers auf timerResolution festzulegen. Der tatsächliche Zeitraum des Timers kann je nach Hardware abweichen. Rufen Sie die timeGetDevCaps-Funktion auf, um die minimale und maximale Timerauflösung zu ermitteln. Die Referenzuhr legt fest, dass die Timerauflösung durch Aufrufen von timeBeginPeriod festgelegt wird. Wenn timerResolution den Wert 0 aufweist, bricht die Methode die vorherige Timeranforderung ab, indem timeEndPeriod aufgerufen wird. (Wenn die Referenzuhr zerstört wird, wird jede vorherige Anforderung automatisch abgebrochen.)

Wenn diese Methode nicht aufgerufen wird, legt die Referenzuhr die Timerauflösung auf 1 Millisekunde fest. Um die beste Energieverwaltungsleistung zu erzielen, wird empfohlen, diese Methode mit dem Wert 0 (null) aufzurufen. Dadurch wird die Standardeinstellung der Uhr von 1 Millisekunde überschrieben. Wenn Filter im Diagramm eine höhere Timerauflösung erfordern, können sie timeBeginPeriod einzeln aufrufen. In der Regel sollten nur Renderer eine bestimmte Timerauflösung erfordern.

Anforderungen

Weitere Informationen

Fehler- und Erfolgscodes

IReferenceClockTimerControl-Schnittstelle