Share via

Função MFBeginRegisterWorkQueueWithMMCSSEx (mfapi.h)

  • Artigo

Associa uma fila de trabalho a uma tarefa MMCSS (Serviço de Agendador de Classe Multimídia).

Sintaxe

HRESULT MFBeginRegisterWorkQueueWithMMCSSEx(
  [in] DWORD            dwWorkQueueId,
  [in] LPCWSTR          wszClass,
  [in] DWORD            dwTaskId,
  [in] LONG             lPriority,
  [in] IMFAsyncCallback *pDoneCallback,
  [in] IUnknown         *pDoneState
);

Parâmetros

[in] dwWorkQueueId

O identificador da fila de trabalho. Para filas de trabalho privadas, o identificador é retornado pela função MFAllocateWorkQueue . Para filas de trabalho de plataforma, consulte Identificadores de Fila de Trabalho.

[in] wszClass

O nome da tarefa MMCSS. Para obter mais informações, consulte Multimídia Class Scheduler Service.

[in] dwTaskId

O identificador de tarefa exclusivo. Para obter um novo identificador de tarefa, defina esse valor como zero.

[in] lPriority

A prioridade relativa base para os threads da fila de trabalho. Para obter mais informações, consulte AvSetMmThreadPriority.

[in] pDoneCallback

Um ponteiro para a interface IMFAsyncCallback de um objeto de retorno de chamada. O chamador deve implementar essa interface.

[in] pDoneState

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

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

Comentários

Essa função estende a função MFBeginRegisterWorkQueueWithMMCSS adicionando o parâmetro lPriority .

Essa função é assíncrona. Quando a operação for concluída, o método IMFAsyncCallback::Invoke do objeto de retorno de chamada será chamado. Nesse ponto, chame MFEndRegisterWorkQueueWithMMCSS para concluir a solicitação assíncrona.

Para cancelar o registro da fila de trabalho da tarefa MMCSS, chame MFBeginUnregisterWorkQueueWithMMCSS.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mfapi.h
DLL Mfplat.dll

Confira também

Funções do Media Foundation

Melhorias na fila de trabalho e no threading

Filas de Trabalho