Método IReferenceClock::AdviseTime

[La característica asociada a esta página, SDK de Windows Media Format 11, es una característica heredada. Se ha reemplazado por lector de origen y escritor receptor. El lector de origen y el sistema de escritura receptor se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use lector de origen y escritor receptor en lugar del SDK de Windows Media Format 11, 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 método AdviseTime solicita una notificación asincrónica que ha transcurrido un tiempo.

Sintaxis

HRESULT AdviseTime(
  [in]  REFERENCE_TIME rtBaseTime,
  [in]  REFERENCE_TIME rtStreamTime,
  [in]  HEVENT         hEvent,
  [out] DWORD          *pdwAdviseCookie
);

Parámetros

rtBaseTime [in]

Hora de referencia base, en unidades de 100 nanosegundos.

rtStreamTime [in]

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

hEvent [in]

Identificador de un evento, creado por el autor de la llamada. Este evento se indicará cuando transcurre el tiempo especificado.

pdwAdviseCookie [out]

Puntero a una variable que recibe un identificador para la solicitud. Se usa para identificar esta llamada a AdviseTime en el futuro, por ejemplo, para cancelar la solicitud.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_POINTER	El parámetro pdwAdviseCookie es NULL.
E_FAIL	Error no especificado.

Consulte también

IReferenceClock (Interfaz)