Método IMFRealTimeClientEx::RegisterThreadsEx (mfidl.h)

  • Artículo

Notifica al objeto que registre sus subprocesos de trabajo con el Servicio de programador de clases multimedia (MMCSS).

Sintaxis

HRESULT RegisterThreadsEx(
  [in, out] DWORD   *pdwTaskIndex,
  [in]      LPCWSTR wszClassName,
  [in]      LONG    lBasePriority
);

Parámetros

[in, out] pdwTaskIndex

Identificador de tarea MMCSS. Si el valor es cero en la entrada, el objeto debe crear un nuevo grupo de tareas MCCSS. Vea la sección Comentarios.

[in] wszClassName

Nombre de la tarea MMCSS.

[in] lBasePriority

Prioridad base del subproceso.

Valor devuelto

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

Comentarios

Si el objeto no crea subprocesos de trabajo, el método simplemente debe devolver S_OK y no realizar ninguna otra acción.

De lo contrario, si el valor de *pdwTaskIndex es cero en la entrada, el objeto debe realizar los pasos siguientes:

  1. Un único subproceso de trabajo llama a AvSetMmThreadCharacteristics para crear un nuevo identificador de tarea MMCSS. Almacene este valor.
  2. Los subprocesos de trabajo adicionales llaman a AvSetMmThreadCharacteristics mediante el nuevo identificador de tarea.
  3. Devuelve el nuevo identificador de tarea al autor de la llamada estableciendo *pdwTaskIndex igual al identificador de tarea.
Si el valor de es distinto de *pdwTaskIndex cero en la entrada, el parámetro contiene un identificador de tarea MMCSS existente. En ese caso, todos los subprocesos de trabajo del objeto deben registrarse para esa tarea llamando a AvSetMmThreadCharacteristics.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado mfidl.h

Consulte también

IMFRealTimeClientEx

Mejoras en la cola de trabajo y los subprocesos