timeBeginPeriod-Funktion (timeapi.h)
Die timeBeginPeriod-Funktion fordert eine Mindestauflösung für regelmäßige Timer an.
Syntax
MMRESULT timeBeginPeriod(
UINT uPeriod
);
Parameter
uPeriod
Minimale Timerauflösung in Millisekunden für die Anwendung oder den Gerätetreiber. Ein niedrigerer Wert gibt eine höhere (genauere) Auflösung an.
Rückgabewert
Gibt TIMERR_NOERROR zurück, wenn erfolgreich oder TIMERR_NOCANDO , wenn die in uPeriod angegebene Auflösung außerhalb des Bereichs liegt.
Hinweise
Rufen Sie diese Funktion unmittelbar vor der Verwendung von Timerdiensten auf, und rufen Sie die timeEndPeriod-Funktion sofort auf, nachdem Sie die Zeitgeberdienste verwendet haben.
Sie müssen jeden Aufruf von timeBeginPeriod mit einem Aufruf von timeEndPeriod abgleichen und dabei die gleiche Mindestauflösung in beiden Aufrufen angeben. Eine Anwendung kann mehrere timeBeginPeriod-Aufrufe tätigen, solange jeder Aufruf mit einem Aufruf von timeEndPeriod übereinstimmt.
Vor Windows 10 Version 2004 wirkt sich diese Funktion auf eine globale Windows-Einstellung aus. Für alle Prozesse verwendet Windows den niedrigsten Wert (d. h. die höchste Auflösung), die von jedem Prozess angefordert wird. Ab Windows 10 Version 2004 wirkt sich diese Funktion nicht mehr auf die globale Timerauflösung aus. Für Prozesse, die diese Funktion aufrufen, verwendet Windows den niedrigsten Wert (d. h. die höchste Auflösung), die von jedem Prozess angefordert wird. Für Prozesse, die diese Funktion nicht aufgerufen haben, garantiert Windows keine höhere Auflösung als die Standardsystemauflösung.
Ab Windows 11 garantiert Windows keine höhere Auflösung als die Standardsystemauflösung, wenn ein Fenster besitzender Prozess vollständig verdeckt, minimiert oder anderweitig unsichtbar oder unhörbar für den Endbenutzer wird. Weitere Informationen zu diesem Verhalten finden Sie unter SetProcessInformation .
Das Festlegen einer höheren 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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | timeapi.h (Windows.h einschließen) |
| Bibliothek | Winmm.lib |
| DLL | Winmm.dll |