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

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El SetDefaultTimerResolution método establece la resolución mínima del temporizador.

Sintaxis

HRESULT SetDefaultTimerResolution(
  [in] REFERENCE_TIME timerResolution
);

Parámetros

[in] timerResolution

Resolución mínima del temporizador, en unidades de 100 nanosegundos. Si el valor es cero, el reloj de referencia cancela su solicitud anterior.

Valor devuelto

Devuelve un valor HRESULT . Estos son algunos de los valores posibles.

Código devuelto	Descripción
S_OK	Correcto.

Comentarios

El reloj de referencia intenta establecer el período del temporizador en timerResolution. El período real del temporizador puede diferir, dependiendo del hardware. Para buscar la resolución de temporizador mínima y máxima, llame a la función timeGetDevCaps . El reloj de referencia establece la resolución del temporizador mediante una llamada a timeBeginPeriod. Si timerResolution es 0, el método cancela la solicitud del temporizador anterior llamando a timeEndPeriod. (Cuando se destruye el reloj de referencia, cancela automáticamente cualquier solicitud anterior).

Si no se llama a este método, el reloj de referencia establece la resolución del temporizador en 1 milisegundos. Para obtener el mejor rendimiento de administración de energía, se recomienda llamar a este método con el valor cero. Esto invalida la configuración predeterminada del reloj de 1 milisegundo. Si algún filtro del gráfico requiere una resolución de temporizador más alta, puede llamar a timeBeginPeriod individualmente. Normalmente, solo los representadores deben requerir una resolución de temporizador determinada.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	strmif.h (incluye Dshow.h)
Library	Strmiids.lib

Consulte también

Códigos de error y éxito

IReferenceClockTimerControl (Interfaz)