Función timeBeginPeriod (timeapi.h)

La función timeBeginPeriod solicita una resolución mínima para temporizadores periódicos.

Sintaxis

MMRESULT timeBeginPeriod(
  UINT uPeriod
);

Parámetros

uPeriod

Resolución mínima del temporizador, en milisegundos, para la aplicación o el controlador de dispositivo. Un valor inferior especifica una resolución más alta (más precisa).

Valor devuelto

Devuelve TIMERR_NOERROR si se ejecuta correctamente o TIMERR_NOCANDO si la resolución especificada en uPeriod está fuera del intervalo.

Comentarios

Llame a esta función inmediatamente antes de usar los servicios de temporizador y llame a la función timeEndPeriod inmediatamente después de terminar de usar los servicios del temporizador.

Debe coincidir cada llamada a timeBeginPeriod con una llamada a timeEndPeriod, especificando la misma resolución mínima en ambas llamadas. Una aplicación puede realizar varias llamadas timeBeginPeriod siempre que cada llamada coincida con una llamada a timeEndPeriod.

Antes de Windows 10, versión 2004, esta función afecta a una configuración global de Windows. Para todos los procesos, Windows usa el valor más bajo (es decir, la resolución más alta) solicitado por cualquier proceso. A partir de Windows 10, versión 2004, esta función ya no afecta a la resolución global del temporizador. En el caso de los procesos que llaman a esta función, Windows usa el valor más bajo (es decir, la resolución más alta) solicitado por cualquier proceso. En el caso de los procesos que no han llamado a esta función, Windows no garantiza una resolución más alta que la resolución predeterminada del sistema.

A partir de Windows 11, si un proceso propietario de ventana se ocluye completamente, minimizado o invisible o inaudible para el usuario final, Windows no garantiza una resolución mayor que la resolución predeterminada del sistema. Consulte SetProcessInformation para obtener más información sobre este comportamiento.

Establecer una resolución más alta puede mejorar la precisión de los intervalos de tiempo de espera en las funciones de espera. Sin embargo, también puede reducir el rendimiento general del sistema, ya que el programador de subprocesos cambia las tareas con más frecuencia. Las resoluciones altas también pueden impedir que el sistema de administración de energía de la CPU entre en modos de ahorro de energía. Establecer una resolución más alta no mejora la precisión del contador de rendimiento de alta resolución.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	timeapi.h (incluye Windows.h)
Library	Winmm.lib
Archivo DLL	Winmm.dll

Consulte también

Funciones del temporizador multimedia

Temporizadores multimedia