Função MFScheduleWorkItem (mfapi.h)

Agenda uma operação assíncrona a ser concluída após um intervalo especificado.

Sintaxe

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

Parâmetros

[in] pCallback

Ponteiro para a interface IMFAsyncCallback . O chamador deve implementar essa interface.

[in] pState

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.

[in] Timeout

Intervalo de tempo limite, em milissegundos. Defina esse parâmetro como um valor negativo. O retorno de chamada é invocado após −Timeout milissegundos. Por exemplo, se Timeout for −5000, o retorno de chamada será invocado após 5000 milissegundos.

[out] pKey

Recebe uma chave que pode ser usada para cancelar o temporizador. Para cancelar o temporizador, chame MFCancelWorkItem e passe essa chave no parâmetro Key .

Retornar valor

A função 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
A função foi bem-sucedida.

Comentários

Essa função cria um objeto de resultado assíncrono. Quando o intervalo de temporizador decorre, o método IMFAsyncCallback::Invoke especificado por pCallback é chamado.

Essa função estará disponível nas seguintes plataformas se os componentes redistribuíveis do SDK do Windows Media Format 11 estiverem instalados:

  • Windows XP com Service Pack 2 (SP2) e posterior.
  • Windows XP Media Center Edition 2005 com KB900325 (Windows XP Media Center Edition 2005) e KB925766 (pacote cumulativo de atualizações de outubro de 2006 para Windows XP Media Center Edition) instalados.

Requisitos

Requisito Valor
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 mfapi.h
Biblioteca Mfplat.lib
DLL Mfplat.dll

Confira também

MFScheduleWorkItemEx

Funções do Media Foundation

Filas de Trabalho