Share via

Função MFPutWorkItemEx (mfapi.h)

  • Artigo

Coloca uma operação assíncrona em uma fila de trabalho.

Sintaxe

HRESULT MFPutWorkItemEx(
  [in] DWORD          dwQueue,
  [in] IMFAsyncResult *pResult
);

Parâmetros

[in] dwQueue

O identificador da fila de trabalho. Esse valor pode especificar uma das filas de trabalho padrão do Media Foundation ou uma fila de trabalho criada pelo aplicativo. Para obter a lista de filas de trabalho padrão do Media Foundation, consulte Identificadores de fila de trabalho. Para criar uma nova fila de trabalho, chame MFAllocateWorkQueue ou MFAllocateWorkQueueEx.

[in] pResult

Um ponteiro para a interface IMFAsyncResult de um objeto de resultado assíncrono. Para criar o objeto de resultado, chame MFCreateAsyncResult.

Retornar valor

Retorna um valor HRESULT . Os possíveis valores incluem os seguintes.

Código de retorno Descrição
S_OK
 Êxito.
MF_E_INVALID_WORKQUEUE
 Identificador de fila de trabalho inválido. Para obter mais informações, consulte IMFAsyncCallback::GetParameters.
MF_E_SHUTDOWN
 A função MFStartup não foi chamada ou MFShutdown foi chamado.

Comentários

Para invocar o item de trabalho, essa função passa pResult para a função MFInvokeCallback . O retorno de chamada é especificado quando você cria o objeto de resultado especificado por pResult.

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

MFPutWorkItem

Funções do Media Foundation

Filas de Trabalho