Compartilhar via


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

Requirements

Requirement Value
Cliente mínimo suportado Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo compatível Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
da Plataforma de Destino Windows
Header mfapi.h
Library Mfplat.lib
de DLL Mfplat.dll

Consulte também

Funções do Media Foundation

Melhorias na fila de trabalho e no threading

Filas de trabalho