MÉTODO IMFWorkQueueServices::BeginRegisterTopologyWorkQueuesWithMMCSS (mfidl.h)

Registra las colas de trabajo de topología con el servicio de programador de clases multimedia (MMCSS).

Sintaxis

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

Parámetros

[in] pCallback

Puntero a la interfaz IMFAsyncCallback de un objeto de devolución de llamada. El autor de la llamada debe implementar esta interfaz.

[in] pState

Puntero a la interfaz IUnknown de un objeto de estado definido por el autor de la llamada. Este parámetro puede ser NULL. Puede usar este objeto para contener información de estado. El objeto se devuelve al autor de la llamada cuando se invoca la devolución de llamada.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Cada nodo de origen de la topología define una rama de la topología. La rama incluye todos los nodos de topología que reciben datos de ese nodo. Una aplicación puede asignar cada rama de una topología a su propia cola de trabajo y, a continuación, asociar esas colas de trabajo con tareas de MMCSS.

Para usar este método, realice los pasos siguientes.

1. Cree la topología.
2. Establezca los siguientes atributos en los nodos de origen de la topología.
   • MF_TOPONODE_WORKQUEUE_ID. Especifica un identificador para la cola de trabajo. La sesión multimedia asignará una nueva cola de trabajo.
   • MF_TOPONODE_WORKQUEUE_MMCSS_CLASS. Especifica la clase MMCSS.
   • MF_TOPONODE_WORKQUEUE_MMCSS_TASKID. Especifica el identificador de tarea MMCSS (opcional). Si no se establece este atributo, MMCSS asigna un nuevo identificador de tarea.
3. Poner en cola la topología llamando a IMFMediaSession::SetTopology.
4. Espere al evento MESessionTopologyStatus con el estado MF_TOPOSTATUS_READY .
5. Llame a BeginRegisterTopologyWorkQueuesWithMMCSS. Este método registra todas las colas de trabajo de topología con MMCSS.

El método BeginRegisterTopologyWorkQueuesWithMMCSS es asincrónico. Cuando se completa la operación, se llama al método IMFAsyncCallback::Invoke del objeto de devolución de llamada. En el método de devolución de llamada, llame a IMFWorkQueueServices::EndRegisterTopologyWorkQueuesWithMMCSS para completar la solicitud asincrónica. Una vez completada esta operación, la sesión multimedia registra automáticamente las colas de trabajo para cada nueva topología que se pone en cola en la sesión multimedia. La aplicación no necesita volver a llamar al método para nuevas topologías.

Para anular el registro de las colas de trabajo de topología de MMCSS, llame a IMFWorkQueueServices::BeginUnregisterTopologyWorkQueuesWithMMCSS.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	mfidl.h
Library	Mfuuid.lib

Consulte también

IMFWorkQueueServices