Método IMFTimer::SetTimer (mfidl.h)

Define um temporizador que invoca um retorno de chamada no momento especificado.

Sintaxe

HRESULT SetTimer(
  [in]  DWORD            dwFlags,
  [in]  LONGLONG         llClockTime,
  [in]  IMFAsyncCallback *pCallback,
  [in]  IUnknown         *punkState,
  [out] IUnknown         **ppunkKey
);

Parâmetros

[in] dwFlags

OR bit a bit de zero ou mais sinalizadores da enumeração MFTIMER_FLAGS .

[in] llClockTime

A hora em que o temporizador deve ser acionado, em unidades da frequência do relógio. A hora é absoluta ou relativa à hora atual, dependendo do valor de dwFlags.

[in] pCallback

Ponteiro para a interface IMFAsyncCallback de um objeto de retorno de chamada. O chamador deve implementar essa interface. O método Invoke do retorno de chamada é chamado no momento especificado no parâmetro llClockTime .

[in] punkState

Ponteiro para a interface IUnknown de um objeto de estado, definido pelo chamador. Este parâmetro pode ser NULL. Você pode usar esse objeto para armazenar informações de estado. O objeto é retornado ao chamador quando o retorno de chamada é invocado.

[out] ppunkKey

Recebe um ponteiro para a interface IUnknown de um objeto de cancelamento. O chamador deve liberar a interface. Para cancelar o temporizador, passe esse ponteiro para o método IMFTimer::CancelTimer . Este parâmetro pode ser NULL.

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_SHUTDOWN	O relógio foi desligado.
MF_S_CLOCK_STOPPED	O método foi bem-sucedido, mas o relógio foi interrompido.

Comentários

Se o relógio for interrompido, o método retornará MF_S_CLOCK_STOPPED. O retorno de chamada não será invocado até que o relógio seja iniciado.

Requisitos

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

Confira também

IMFTimer