Método IMFPresentationTimeSource::GetUnderlyingClock (mfidl.h)
Recupera o relógio subjacente que a fonte de horário de apresentação usa para gerar seus horários de relógio.
Sintaxe
HRESULT GetUnderlyingClock(
[out] IMFClock **ppClock
);
Parâmetros
[out] ppClock
Recebe um ponteiro para a interface IMFClock do relógio. O chamador deve liberar a interface .
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 |
|---|---|
|
O método foi bem-sucedido. |
|
Essa fonte de tempo não expõe um relógio subjacente. |
Comentários
Uma fonte de tempo de apresentação deve dar suporte a alterações de interrupção, inicialização, pausa e taxa. No entanto, em muitos casos, a fonte de tempo deriva seus horários de relógio de um relógio de hardware ou de outro dispositivo. O relógio subjacente está sempre em execução e pode não dar suporte a alterações de taxa.
Opcionalmente, uma fonte de tempo pode expor o relógio subjacente implementando esse método. O relógio subjacente está sempre em execução, mesmo quando a origem da hora da apresentação é pausada ou interrompida. (Portanto, o relógio subjacente retorna o sinalizador MFCLOCK_CHARACTERISTICS_FLAG_ALWAYS_RUNNING no método IMFClock::GetClockCharacteristics ).
O relógio subjacente é útil se você quiser tomar decisões com base nos horários do relógio enquanto o relógio de apresentação é interrompido ou pausado.
Se a fonte de tempo não expor um relógio subjacente, o método retornará MF_E_NO_CLOCK.
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 |