Função MFBeginRegisterWorkQueueWithMMCSS (mfapi.h)

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

Sintaxe

HRESULT MFBeginRegisterWorkQueueWithMMCSS(
  [in] DWORD            dwWorkQueueId,
  [in] LPCWSTR          wszClass,
  [in] DWORD            dwTaskId,
  [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] 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.

Valor retornado

A função retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	A função foi bem-sucedida.

Comentários

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, o aplicativo deve chamar MFEndRegisterWorkQueueWithMMCSS para concluir a solicitação assíncrona.

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

Requisitos

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

Funções do Media Foundation

Filas de Trabalho