Método IReferenceClockTimerControl::SetDefaultTimerResolution (strmif.h)

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in 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 Audio/Video Capture in 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.]

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

Sintaxe

HRESULT SetDefaultTimerResolution(
  [in] REFERENCE_TIME timerResolution
);

Parâmetros

[in] timerResolution

Resolução mínima do temporizador, em unidades de 100 nanossegundos. Se o valor for zero, o relógio de referência cancelará sua solicitação anterior.

Retornar valor

Retorna um valor HRESULT . Os possíveis valores incluem os seguintes.

Código de retorno	Descrição
S_OK	Êxito.

Comentários

O relógio de referência tenta definir o período do temporizador como timerResolution. O período real do temporizador pode ser diferente, dependendo do hardware. Para localizar a resolução mínima e máxima do temporizador, chame a função timeGetDevCaps . O relógio de referência define que a resolução do temporizador é definida chamando timeBeginPeriod. Se timerResolution for 0, o método cancelará a solicitação de temporizador anterior chamando timeEndPeriod. (Quando o relógio de referência é destruído, ele cancela automaticamente qualquer solicitação anterior.)

Se esse método não for chamado, o relógio de referência definirá a resolução do temporizador como 1 milissegundo. Para obter o melhor desempenho de gerenciamento de energia, é recomendável que você chame esse método com o valor zero. Isso substitui a configuração padrão do relógio de 1 milissegundo. Se algum filtro no grafo exigir uma resolução de temporizador mais alta, eles poderão chamar timeBeginPeriod individualmente. Normalmente, somente os renderizadores devem exigir uma resolução de temporizador específica.

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)
Biblioteca	Strmiids.lib

Confira também

Códigos de erro e êxito

IReferenceClockTimerControl Interface