Metodo IReferenceClockTimerControl::SetDefaultTimerResolution (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.

Il SetDefaultTimerResolution metodo imposta la risoluzione minima del timer.

Sintassi

HRESULT SetDefaultTimerResolution(
  [in] REFERENCE_TIME timerResolution
);

Parametri

[in] timerResolution

Risoluzione minima del timer, in unità di 100 nanosecondi. Se il valore è zero, l'orologio di riferimento annulla la richiesta precedente.

Valore restituito

Restituisce un valore HRESULT . Di seguito sono indicati alcuni valori possibili.

Commenti

L'orologio di riferimento tenta di impostare il periodo del timer su timerResolution. Il periodo effettivo del timer potrebbe variare, a seconda dell'hardware. Per trovare la risoluzione del timer minima e massima, chiamare la funzione timeGetDevCaps . L'orologio di riferimento imposta la risoluzione del timer chiamando timeBeginPeriod. Se timerResolution è 0, il metodo annulla la richiesta del timer precedente chiamando timeEndPeriod. Quando l'orologio di riferimento viene eliminato definitivamente, annulla automaticamente qualsiasi richiesta precedente.

Se questo metodo non viene chiamato, l'orologio di riferimento imposta la risoluzione del timer su 1 millisecondo. Per ottenere le migliori prestazioni di risparmio energia, è consigliabile chiamare questo metodo con il valore zero. Questa opzione sostituisce l'impostazione predefinita dell'orologio di 1 millisecondo. Se i filtri nel grafico richiedono una risoluzione timer superiore, possono chiamare timeBeginPeriod singolarmente. In genere, solo i renderer devono richiedere una particolare risoluzione timer.

Requisiti

Vedi anche

Codici di errore e di esito positivo

Interfaccia IReferenceClockTimerControl