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

Establece un temporizador que invoca una devolución de llamada en el momento especificado.

Sintaxis

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 cero o más marcas de la enumeración MFTIMER_FLAGS .

[in] llClockTime

Hora a la que se debe activar el temporizador, en unidades de la frecuencia del reloj. La hora es absoluta o relativa a la hora actual, dependiendo del valor de dwFlags.

[in] pCallback

Puntero a la interfaz IMFAsyncCallback de un objeto de devolución de llamada. El autor de la llamada debe implementar esta interfaz. Se llama al método Invoke de la devolución de llamada en el momento especificado en el parámetro llClockTime .

[in] punkState

Puntero a la interfaz IUnknown de un objeto de estado, definido por el autor de la llamada. Este parámetro puede ser NULL. Puede usar este objeto para contener información de estado. El objeto se devuelve al autor de la llamada cuando se invoca la devolución de llamada.

[out] ppunkKey

Recibe un puntero a la interfaz IUnknown de un objeto de cancelación. El autor de la llamada debe liberar la interfaz . Para cancelar el temporizador, pase este puntero al método IMFTimer::CancelTimer . Este parámetro puede ser NULL.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
MF_E_SHUTDOWN	El reloj se cerró.
MF_S_CLOCK_STOPPED	El método se realizó correctamente, pero el reloj se detiene.

Comentarios

Si se detiene el reloj, el método devuelve MF_S_CLOCK_STOPPED. La devolución de llamada no se invocará hasta que se inicie el reloj.

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	mfidl.h
Library	Mfuuid.lib

Consulte también

IMFTimer