Método IReferenceClock::AdviseTime (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 AdviseTime método crea una solicitud de aviso único.

Sintaxis

HRESULT AdviseTime(
  [in]  REFERENCE_TIME baseTime,
  [in]  REFERENCE_TIME streamTime,
  [in]  HEVENT         hEvent,
  [out] DWORD_PTR      *pdwAdviseCookie
);

Parámetros

[in] baseTime

Tiempo de referencia base, en unidades de 100 nanosegundos. Vea la sección Comentarios.

[in] streamTime

Stream tiempo de desplazamiento, en unidades de 100 nanosegundos. Vea la sección Comentarios.

[in] hEvent

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

[out] pdwAdviseCookie

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

Valor devuelto

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

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.

Comentarios

Este método crea una solicitud de aviso único para la hora de referencia rtBaseTime + rtStreamTime. 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 indica el evento especificado en el parámetro hEvent .

Para cancelar la notificación antes de que se alcance la hora, llame al método 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
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [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

IReferenceClock (Interfaz)