Método IMFWorkQueueServices::BeginRegisterTopologyWorkQueuesWithMMCSS (mfidl.h)

Registra as filas de trabalho de topologia com o MMCSS (Serviço de Agendador de Classe Multimídia).

Sintaxe

HRESULT BeginRegisterTopologyWorkQueuesWithMMCSS(
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *pState
);

Parâmetros

[in] pCallback

Um ponteiro para a interface IMFAsyncCallback de um objeto de retorno de chamada. 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

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Cada nó de origem na topologia define um branch da topologia. O branch inclui todos os nós de topologia que recebem dados desse nó. Um aplicativo pode atribuir a cada branch de uma topologia sua própria fila de trabalho e associar essas filas de trabalho a tarefas do MMCSS.

Para usar esse método, execute as etapas a seguir.

1. Crie a topologia.
2. Defina os atributos a seguir nos nós de origem na topologia.
   • MF_TOPONODE_WORKQUEUE_ID. Especifica um identificador para a fila de trabalho. A Sessão de Mídia alocará uma nova fila de trabalho.
   • MF_TOPONODE_WORKQUEUE_MMCSS_CLASS. Especifica a classe MMCSS.
   • MF_TOPONODE_WORKQUEUE_MMCSS_TASKID. Especifica o identificador de tarefa MMCSS (opcional). Se esse atributo não estiver definido, o MMCSS atribuirá um novo identificador de tarefa.
3. Enfileirar a topologia chamando IMFMediaSession::SetTopology.
4. Aguarde o evento MESessionTopologyStatus com o MF_TOPOSTATUS_READY status.
5. Chame BeginRegisterTopologyWorkQueuesWithMMCSS. Esse método registra todas as filas de trabalho de topologia com o MMCSS.

O método BeginRegisterTopologyWorkQueuesWithMMCSS é assíncrono. Quando a operação for concluída, o método IMFAsyncCallback::Invoke do objeto de retorno de chamada será chamado. No método de retorno de chamada, chame IMFWorkQueueServices::EndRegisterTopologyWorkQueuesWithMMCSS para concluir a solicitação assíncrona. Após a conclusão dessa operação, a Sessão de Mídia registra automaticamente as filas de trabalho para cada nova topologia enfileirada na Sessão de Mídia. O aplicativo não precisa chamar o método novamente para novas topologias.

Para cancelar o registro das filas de trabalho de topologia do MMCSS, chame IMFWorkQueueServices::BeginUnregisterTopologyWorkQueuesWithMMCSS.

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	mfidl.h
Biblioteca	Mfuuid.lib

Confira também

IMFWorkQueueServices