funzione timeBeginPeriod (timeapi.h)

La funzione timeBeginPeriod richiede una risoluzione minima per i timer periodici.

Sintassi

MMRESULT timeBeginPeriod(
  UINT uPeriod
);

Parametri

uPeriod

Risoluzione minima del timer, in millisecondi, per l'applicazione o il driver di dispositivo. Un valore inferiore specifica una risoluzione più elevata (più accurata).

Valore restituito

Restituisce TIMERR_NOERROR se ha esito positivo o TIMERR_NOCANDO se la risoluzione specificata in uPeriod non è compreso nell'intervallo.

Commenti

Chiamare questa funzione immediatamente prima di usare i servizi timer e chiamare la funzione timeEndPeriod immediatamente dopo aver completato l'uso dei servizi timer.

È necessario corrispondere a ogni chiamata a timeBeginPeriod con una chiamata a timeEndPeriod, specificando la stessa risoluzione minima in entrambe le chiamate. Un'applicazione può effettuare più chiamate timeBeginPeriod fino a quando ogni chiamata viene corrispondente a una chiamata a timeEndPeriod.

Prima di Windows 10, versione 2004, questa funzione influisce su un'impostazione globale di Windows. Per tutti i processi Windows usa il valore più basso (ovvero la risoluzione più elevata) richiesto da qualsiasi processo. A partire da Windows 10, versione 2004, questa funzione non influisce più sulla risoluzione timer globale. Per i processi che chiamano questa funzione, Windows usa il valore più basso (ovvero la risoluzione più alta) richiesto da qualsiasi processo. Per i processi che non hanno chiamato questa funzione, Windows non garantisce una risoluzione maggiore rispetto alla risoluzione predefinita del sistema.

A partire da Windows 11, se un processo di proprietà della finestra diventa completamente occluso, ridotto al minimo o altrimenti invisibile o inaudibile all'utente finale, Windows non garantisce una risoluzione più elevata rispetto alla risoluzione predefinita del sistema. Per altre informazioni su questo comportamento, vedere SetProcessInformation .

L'impostazione di una risoluzione superiore può migliorare l'accuratezza degli intervalli di timeout nelle funzioni di attesa. Tuttavia, può anche ridurre le prestazioni complessive del sistema, perché l'utilità di pianificazione thread cambia le attività più spesso. Le risoluzioni elevate possono anche impedire al sistema di risparmio energia della CPU di immettere le modalità di risparmio energia. L'impostazione di una risoluzione superiore non migliora l'accuratezza del contatore delle prestazioni ad alta risoluzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	timeapi.h (include Windows.h)
Libreria	Winmm.lib
DLL	Winmm.dll

Vedi anche

Funzioni timer multimediali

Timer multimediali