Función MFBeginRegisterWorkQueueWithMMCSSEx (mfapi.h)

Asocia una cola de trabajo a una tarea de Servicio de programador de clases multimedia (MMCSS).

Sintaxis

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

Parámetros

[in] dwWorkQueueId

Identificador de la cola de trabajo. Para las colas de trabajo privadas, la función MFAllocateWorkQueue devuelve el identificador. Para ver las colas de trabajo de la plataforma, consulte Identificadores de cola de trabajo.

[in] wszClass

Nombre de la tarea MMCSS. Para obtener más información, vea Multimedia Class Scheduler Service.

[in] dwTaskId

Identificador de tarea único. Para obtener un nuevo identificador de tarea, establezca este valor en cero.

[in] lPriority

Prioridad relativa base para los subprocesos de cola de trabajo. Para obtener más información, consulte AvSetMmThreadPriority.

[in] pDoneCallback

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

[in] pDoneState

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 esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Esta función extiende la función MFBeginRegisterWorkQueueWithMMCSS agregando el parámetro lPriority .

Esta función es asincrónica. Cuando se completa la operación, se llama al método IMFAsyncCallback::Invoke del objeto de devolución de llamada. En ese momento, llame a MFEndRegisterWorkQueueWithMMCSS para completar la solicitud asincrónica.

Para anular el registro de la cola de trabajo de la tarea MMCSS, llame a MFBeginUnregisterWorkQueueWithMMCSS.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	mfapi.h
Archivo DLL	Mfplat.dll

Consulte también

Funciones de Media Foundation

Mejoras en la cola de trabajo y los subprocesos

Colas de trabajo