Función MFScheduleWorkItem (mfapi.h)

Programa una operación asincrónica que se va a completar después de un intervalo especificado.

Sintaxis

HRESULT MFScheduleWorkItem(
  [in]  IMFAsyncCallback *pCallback,
  [in]  IUnknown         *pState,
  [in]  INT64            Timeout,
  [out] MFWORKITEM_KEY   *pKey
);

Parámetros

[in] pCallback

Puntero a la interfaz IMFAsyncCallback . El autor de la llamada debe implementar esta interfaz.

[in] pState

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.

[in] Timeout

Intervalo de tiempo de espera, en milisegundos. Establezca este parámetro en un valor negativo. La devolución de llamada se invoca después de los milisegundos de tiempo de espera . Por ejemplo, si Timeout es -5000, la devolución de llamada se invoca después de 5000 milisegundos.

[out] pKey

Recibe una clave que se puede usar para cancelar el temporizador. Para cancelar el temporizador, llame a MFCancelWorkItem y pase esta clave en el parámetro Key .

Valor devuelto

La función 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	La función se ha realizado correctamente.

Comentarios

Esta función crea un objeto de resultado asincrónico. Cuando transcurre el intervalo del temporizador, se llama al método IMFAsyncCallback::Invoke especificado por pCallback .

Esta función está disponible en las siguientes plataformas si se instalan los componentes redistribuibles del SDK de Windows Media Format 11:

• Windows XP con Service Pack 2 (SP2) y versiones posteriores.
• Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) y KB925766 (paquete acumulativo de actualizaciones de octubre de 2006 para Windows XP Media Center Edition) instalados.

Requisitos

Requisito	Value
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	mfapi.h
Library	Mfplat.lib
Archivo DLL	Mfplat.dll

Consulte también

MFScheduleWorkItemEx

Funciones de Media Foundation

Colas de trabajo