Método IMFPresentationClock::Start (mfidl.h)

  • Artigo

Inicia o relógio da apresentação.

Sintaxe

HRESULT Start(
  [in] LONGLONG llClockStartOffset
);

Parâmetros

[in] llClockStartOffset

Hora de início inicial, em unidades de 100 nanossegundos. No momento em que o método Start é chamado, o método IMFPresentationClock::GetTime do relógio retorna esse valor e a hora do relógio é incrementada a partir daí. Se o valor for PRESENTATION_CURRENT_POSITION, o relógio começará a partir de sua posição atual. Use esse valor se o relógio estiver em pausa e você quiser reiniciá-lo da mesma posiçã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.
MF_E_CLOCK_NO_TIME_SOURCE
 Nenhuma fonte de tempo foi definida neste relógio.

Comentários

Esse método é válido em todos os estados (parado, pausado ou em execução).

Se o relógio estiver pausado e reiniciado da mesma posição (llClockStartOffset for PRESENTATION_CURRENT_POSITION), o relógio de apresentação enviará uma notificação IMFClockStateSink::OnClockRestart . Caso contrário, o relógio enviará uma notificação IMFClockStateSink::OnClockStart .

O relógio de apresentação inicia a alteração de estado chamando OnClockStart ou OnClockRestart na fonte de tempo do relógio. Essa chamada é feita de forma síncrona. Se falhar, a alteração de estado não ocorrerá. Se a chamada for bem-sucedida, o estado será alterado e o relógio notificará os outros assinantes de alteração de estado chamando seus métodos OnClockStart ou OnClockRestart . Essas chamadas são feitas de forma assíncrona.

Se o relógio já estiver em execução, chamar Iniciar novamente terá o efeito de buscar o relógio para a nova posição StartOffset .

Requisitos

Requisito Valor
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

IMFPresentationClock

Relógio de Apresentação