Função MFPutWorkItemEx2 (mfapi.h)

Coloca uma operação assíncrona em uma fila de trabalho, com uma prioridade especificada.

Sintaxe

HRESULT MFPutWorkItemEx2(
  [in] DWORD          dwQueue,
  [in] LONG           Priority,
  [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] Priority

A prioridade do item de trabalho. Esse valor deve ser 1, 0 ou -1. Itens com um valor de 1 são executados antes de itens com um valor de 0. Itens com um valor de -1 são executados após itens com um valor de 0.

[in] pResult

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

Valor retornado

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

Requisitos

Cliente mínimo com suporte	Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	mfapi.h
Biblioteca	Mfplat.lib
DLL	Mfplat.dll

Confira também

Funções do Media Foundation

Melhorias na fila de trabalho e no threading

Filas de Trabalho