Interfaccia IReferenceClockTimerControl (strmif.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

L'interfaccia IReferenceClockTimerControl modifica il periodo timer utilizzato da un orologio di riferimento. Questa interfaccia è esposta dall'orologio di riferimento del sistema DirectShow.

Ereditarietà

L'interfaccia IReferenceClockTimerControl eredita dall'interfaccia IUnknown . IReferenceClockTimerControl include anche questi tipi di membri:

Metodi

L'interfaccia IReferenceClockTimerControl include questi metodi.

Commenti

Per impostazione predefinita, l'orologio di riferimento di sistema in DirectShow imposta il periodo timer sul valore minimo consentito dal timer. In genere, questo valore è 1 millisecondo.

Il periodo timer è un'impostazione globale in Windows. Una risoluzione più elevata 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 entrare in modalità di risparmio energia. L'impostazione di una risoluzione superiore non migliora l'accuratezza del contatore delle prestazioni ad alta risoluzione.

Lo scopo principale di questa interfaccia è eseguire l'override dell'impostazione predefinita del timer dell'orologio di riferimento. A tale scopo, chiamare SetDefaultTimerResolution con il valore zero. Ciò può comportare una risoluzione timer inferiore, che potrebbe consentire al computer dell'utente di attivare una modalità di risparmio energia. Il comportamento effettivo dipende da molti altri fattori, ad esempio gli altri processi in esecuzione. Il filtro Strumento di navigazione DVD usa questa interfaccia come descritto qui.

Se un filtro DirectShow richiede una risoluzione timer superiore, deve chiamare timeBeginPeriod. In genere, questo requisito si applica solo ai filtri del renderer.

Requisiti