Compartilhar via


Interface IReferenceClockTimerControl (strmif.h)

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

A IReferenceClockTimerControl interface altera o período de temporizador usado por um relógio de referência. Essa interface é exposta pelo Relógio de Referência do Sistema DirectShow.

Herança

A interface IReferenceClockTimerControl herda da interface IUnknown . IReferenceClockTimerControl também tem estes tipos de membros:

Métodos

A interface IReferenceClockTimerControl tem esses métodos.

 
IReferenceClockTimerControl::GetDefaultTimerResolution

O método GetDefaultTimerResolution retorna a resolução do temporizador solicitada pelo relógio de referência.
IReferenceClockTimerControl::SetDefaultTimerResolution

O método SetDefaultTimerResolution define a resolução mínima do temporizador.

Comentários

Por padrão, o relógio de referência do sistema no DirectShow define o período do temporizador como o valor mínimo permitido pelo temporizador. Normalmente, esse valor é de 1 milissegundo.

O período do temporizador é uma configuração global no Windows. Uma resolução mais alta pode melhorar a precisão dos intervalos de tempo limite em funções de espera. No entanto, ele também pode reduzir o desempenho geral do sistema, pois o agendador de thread alterna tarefas com mais frequência. Altas resoluções também podem impedir que o sistema de gerenciamento de energia da CPU insira modos de economia de energia. Definir uma resolução mais alta não melhora a precisão do contador de desempenho de alta resolução.

A main finalidade dessa interface é substituir a configuração de temporizador padrão do relógio de referência. Para fazer isso, chame SetDefaultTimerResolution com o valor zero. Isso pode resultar em uma resolução de temporizador mais baixa, o que pode permitir que o computador do usuário insira um modo de economia de energia. (O comportamento real depende de muitos outros fatores, como quais outros processos estão em execução.) O filtro DVD Navigator usa essa interface, conforme descrito aqui.

Se um filtro DirectShow exigir uma resolução de temporizador mais alta, ele deverá chamar timeBeginPeriod. Normalmente, esse requisito se aplicaria somente a filtros de renderizador.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho strmif.h (inclua Dshow.h)