Share via


Função MFPutWorkItem (mfapi.h)

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

Sintaxe

HRESULT MFPutWorkItem(
  [in] DWORD            dwQueue,
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *pState
);

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 fila de trabalho, chame MFAllocateWorkQueue ou MFAllocateWorkQueueEx.

[in] pCallback

Um ponteiro para a interface IMFAsyncCallback . O chamador deve implementar essa interface.

[in] pState

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

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
Fila de trabalho inválida. 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

Essa função cria um objeto de resultado assíncrono e coloca o objeto de resultado na fila de trabalho. A fila de trabalho chama o método IMFAsyncCallback::Invoke especificado por pCallback.

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

MFPutWorkItemEx

Funções do Media Foundation

Filas de Trabalho