Método IReferenceClock::AdviseTime

[O recurso associado a esta página, Windows Media Format 11 SDK, é um recurso herdado. Ele foi substituído por Leitor de Origem e Gravador de Coletor. O Leitor de Origem e o Gravador do Coletor foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o Leitor de Origem e o Gravador do Coletor em vez do SDK do Windows Media Format 11, 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 método AdviseTime solicita uma notificação assíncrona de que um tempo tenha decorrido.

Sintaxe

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

Parâmetros

rtBaseTime [in]

Tempo de referência base, em unidades de 100 nanossegundos.

rtStreamTime [in]

Tempo de deslocamento de fluxo, em unidades de 100 nanossegundos.

hEvent [in]

Identificador para um evento, criado pelo chamador. Esse evento será sinalizado quando o tempo especificado decorrer.

pdwAdviseCookie [out]

Ponteiro para uma variável que recebe um identificador para a solicitação. Isso é usado para identificar essa chamada para AdviseTime no futuro, por exemplo, para cancelar a solicitação.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_POINTER	O parâmetro pdwAdviseCookie é NULL.
E_FAIL	Falha não especificada.

Confira também

IReferenceClock Interface