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 |
|---|---|
|
Ê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 |