Método CBaseReferenceClock.AdviseTime

[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 AdviseTime método crea una solicitud de aviso único. Este método implementa el método IReferenceClock::AdviseTime .

Sintaxis

HRESULT AdviseTime(
   REFERENCE_TIME baseTime,
   REFERENCE_TIME streamTime,
   HEVENT         hEvent,
   DWORD_PTR      *pdwAdviseToken
);

Parámetros

baseTime

Hora de referencia base, en unidades de 100 nanosegundos.

streamTime

Tiempo de desplazamiento de flujo, en unidades de 100 nanosegundos.

hEvent

Identificador de un evento, creado por el autor de la llamada.

pdwAdviseToken

Puntero a una variable que recibe un identificador para la solicitud de aviso.

Valor devuelto

Devuelve uno de los valores HRESULT que se muestran en la tabla siguiente.

Código devuelto	Descripción
S_OK	Correcto
E_INVALIDARG	Valores de hora no válidos
E_OUTOFMEMORY	Error
E_POINTER	Argumento de puntero NULL

Observaciones

Este método crea una solicitud de aviso único para la hora de referencia baseTime + streamTime. La suma debe ser mayor que cero y menor que MAX_TIME, o el método devuelve E_INVALIDARG. En el momento solicitado, el reloj señala el evento especificado en el parámetro hEvent .

Para cancelar la notificación antes de alcanzar la hora, llame al método CBaseReferenceClock::Unadvise y pase el valor pdwAdviseToken devuelto desde esta llamada. Una vez que se ha producido la notificación, el reloj lo borra automáticamente, por lo que no es necesario llamar a Unadvise. Sin embargo, no es un error hacerlo.

Requisitos

Requisito	Value
Encabezado	Refclock.h (include Streams.h)
Biblioteca	Strmbase.lib (compilaciones comerciales); Strmbasd.lib (compilaciones de depuración)

Consulte también

CBaseReferenceClock (clase)