timeBeginPeriod, fonction (timeapi.h)
La fonction timeBeginPeriod demande une résolution minimale pour les minuteurs périodiques.
Syntaxe
MMRESULT timeBeginPeriod(
UINT uPeriod
);
Paramètres
uPeriod
Résolution minimale du minuteur, en millisecondes, pour l’application ou le pilote de périphérique. Une valeur inférieure spécifie une résolution plus élevée (plus précise).
Valeur retournée
Retourne TIMERR_NOERROR en cas de réussite ou TIMERR_NOCANDO si la résolution spécifiée dans uPeriod est hors limites.
Remarques
Appelez cette fonction immédiatement avant d’utiliser les services de minuteur et appelez la fonction timeEndPeriod immédiatement après avoir terminé d’utiliser les services du minuteur.
Vous devez mettre en correspondance chaque appel à timeBeginPeriod avec un appel à timeEndPeriod, en spécifiant la même résolution minimale dans les deux appels. Une application peut effectuer plusieurs appels timeBeginPeriod tant que chaque appel est mis en correspondance avec un appel à timeEndPeriod.
Avant Windows 10 version 2004, cette fonction affecte un paramètre Windows global. Pour tous les processus, Windows utilise la valeur la plus faible (c’est-à-dire la résolution la plus élevée) demandée par n’importe quel processus. À compter de Windows 10, version 2004, cette fonction n’affecte plus la résolution globale du minuteur. Pour les processus qui appellent cette fonction, Windows utilise la valeur la plus faible (c’est-à-dire la résolution la plus élevée) demandée par n’importe quel processus. Pour les processus qui n’ont pas appelé cette fonction, Windows ne garantit pas une résolution supérieure à la résolution système par défaut.
À compter de Windows 11, si un processus propriétaire de fenêtre devient entièrement obcllu, réduit ou invisible ou inaudible pour l’utilisateur final, Windows ne garantit pas une résolution supérieure à la résolution système par défaut. Pour plus d’informations sur ce comportement, consultez SetProcessInformation .
La définition d’une résolution plus élevée peut améliorer la précision des intervalles de délai d’attente dans les fonctions d’attente. Toutefois, il peut également réduire les performances globales du système, car le planificateur de threads bascule plus souvent les tâches. Des résolutions élevées peuvent également empêcher le système de gestion de l’alimentation du processeur d’entrer en mode d’économie d’énergie. La définition d’une résolution plus élevée n’améliore pas la précision du compteur de performances haute résolution.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | timeapi.h (inclure Windows.h) |
| Bibliothèque | Winmm.lib |
| DLL | Winmm.dll |