Compartilhar via


Função MFPutWorkItemEx (mfapi.h)

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 uma 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.

Valor de retorno

Retorna um valor HRESULT . Os valores possíveis incluem o seguinte.

Código de retorno Description
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.

Observações

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 pelo 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.

Requirements

Requirement Value
Cliente mínimo suportado Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo compatível Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
Header mfapi.h
Library Mfplat.lib
de DLL Mfplat.dll

Consulte também

MFPutWorkItem

Funções do Media Foundation

Filas de trabalho