Função MFPutWaitingWorkItem (mfapi.h)

Enfileira um item de trabalho que aguarda que um evento seja sinalizado.

Sintaxe

HRESULT MFPutWaitingWorkItem(
  [in]  HANDLE         hEvent,
  [in]  LONG           Priority,
  [in]  IMFAsyncResult *pResult,
  [out] MFWORKITEM_KEY *pKey
);

Parâmetros

[in] hEvent

Um identificador para um objeto de evento. Para criar um objeto de evento, chame CreateEvent ou CreateEventEx.

[in] Priority

A prioridade do item de trabalho. Os itens de trabalho são executados em ordem de prioridade.

[in] pResult

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

[out] pKey

Recebe uma chave que pode ser usada para cancelar a espera. Para cancelar a espera, chame MFCancelWorkItem e passe essa chave no parâmetro Key .

Esse parâmetro pode ser NULL.

Valor de retorno

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .

Observações

Essa função permite que um componente aguarde um evento sem bloquear o thread atual.

A função coloca um item de trabalho na fila de trabalho especificada. Este item de trabalho aguarda o evento dado em hEvent ser sinalizado. Quando o evento é sinalizado, o item de trabalho invoca um retorno de chamada. (O retorno de chamada está contido no objeto de resultado fornecido no pResult. Para obter mais informações, consulte MFCreateAsyncResult).

O item de trabalho é expedido em uma fila de trabalho pelo método IMFAsyncCallback::GetParameters do retorno de chamada. A fila de trabalho pode ser qualquer uma das seguintes opções:

• A fila de trabalho padrão (MFASYNC_CALLBACK_QUEUE_STANDARD).
• A fila multithreaded da plataforma (MFASYNC_CALLBACK_QUEUE_MULTITHREADED).
• Uma fila multithread retornada pela função MFLockSharedWorkQueue .
• Uma fila serial criada pela função MFAllocateSerialWorkQueue .

Requirements

Consulte também

Funções do Media Foundation

Melhorias na fila de trabalho e no threading

Filas de trabalho