Función timeBeginPeriod (timeapi.h)

  • Artículo

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 que haya terminado de usar los servicios de temporizador.

Debe coincidir con 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. Para 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 vuelve totalmente ocluido, minimizado o invisible o inaudible para el usuario final, Windows no garantiza una resolución más alta 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 cpu entre en modos de ahorro de energía. Establecer una resolución superior no mejora la precisión del contador de rendimiento de alta resolución.

Requisitos

   
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 (incluya Windows.h)
Library Winmm.lib
Archivo DLL Winmm.dll

Consulte también

Funciones del temporizador multimedia

Temporizadores multimedia