IReferenceClockTimerControl::GetDefaultTimerResolution-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 GetDefaultTimerResolution -Methode gibt die Timerauflösung zurück, die von der Referenzuhr angefordert wurde.
Syntax
HRESULT GetDefaultTimerResolution(
[out] REFERENCE_TIME *pTimerResolution
);
Parameter
[out] pTimerResolution
Empfängt die angeforderte Timerauflösung in 100 Nanosekundeneinheiten.
Rückgabewert
Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.
| Rückgabecode | Beschreibung |
|---|---|
|
Erfolg. |
|
NULL-Zeigerargument. |
Bemerkungen
Der in pTimerResolution zurückgegebene Wert ist der Zeitraum, den die Referenzuhr für den zugrunde liegenden Timer festzulegen versucht. Der tatsächliche Zeitgeberzeitraum kann je nach Hardware abweichen. Wenn die Referenzuhr keine minimale Timerauflösung angefordert hat, empfängt der Parameter pTimerResolution den Wert 0 .
Anforderungen
| 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) |
| Bibliothek | Strmiids.lib |