Método IMFClockStateSink::OnClockStop (mfidl.h)

  • Artigo

Chamado quando o relógio da apresentação para.

Sintaxe

HRESULT OnClockStop(
  [in] MFTIME hnsSystemTime
);

Parâmetros

[in] hnsSystemTime

A hora do sistema quando o relógio parou, em unidades de 100 nanossegundos.

Valor retornado

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.
MF_E_SINK_ALREADYSTOPPED
 Preterido. Não use este código de erro.

Comentários

Quando o método IMFPresentationClock::Stop do relógio de apresentação é chamado, o relógio notifica a fonte de hora da apresentação chamando o método OnClockStop da fonte de hora da apresentação. Essa chamada ocorre de forma síncrona dentro do método Stop . Se a fonte de tempo retornar um erro de OnClockStop, o método Stop do relógio de apresentação retornará um erro e a alteração de estado não ocorrerá.

Para qualquer objeto que não seja a fonte de tempo de apresentação, o método OnClockStop é chamado de forma assíncrona, depois que a alteração de estado é concluída.

Se um objeto já estiver parado, ele deverá retornar S_OK de OnClockStop. Ele não deve retornar um código de erro.

Nota Embora o arquivo de cabeçalho mferror.h defina um código de erro chamado MF_E_SINK_ALREADYSTOPPED, ele não deve ser retornado nessa situação.
 

Requisitos

   
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho mfidl.h
Biblioteca Mfuuid.lib

Confira também

IMFClockStateSink

MFTIME

Relógio de Apresentação