Función MFAllocateSerialWorkQueue (mfapi.h)

  • Artículo

Crea una cola de trabajo garantizada para serializar elementos de trabajo. La cola de trabajo serie encapsula una cola de trabajo multiproceso existente. La cola de trabajo serie aplica un orden de ejecución primero en salir (FIFO).

Sintaxis

HRESULT MFAllocateSerialWorkQueue(
  [in]  DWORD dwWorkQueue,
  [out] DWORD *pdwWorkQueue
);

Parámetros

[in] dwWorkQueue

Identificador de una cola de trabajo existente. Debe ser una cola multiproceso u otra cola de trabajo serie. Se puede usar cualquiera de las siguientes opciones:

  • Cola de trabajo predeterminada (MFASYNC_CALLBACK_QUEUE_STANDARD)
  • La cola multiproceso de la plataforma (MFASYNC_CALLBACK_QUEUE_MULTITHREADED)
  • Una cola multiproceso devuelta por la función MFLockSharedWorkQueue .
  • Una cola serie creada por la función MFAllocateSerialWorkQueue .

[out] pdwWorkQueue

Recibe un identificador para la nueva cola de trabajo serie. Use este identificador al poner en cola elementos de trabajo.

Valor devuelto

Esta función puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 La función se ha realizado correctamente.
E_FAIL
 La aplicación superó el número máximo de colas de trabajo.
MF_E_SHUTDOWN
 La aplicación no llamó a MFStartup o la aplicación ya ha llamado MFShutdown.

Comentarios

Cuando haya terminado de usar la cola de trabajo, llame a MFUnlockWorkQueue.

Las colas multiproceso usan un grupo de subprocesos, lo que puede reducir el número total de subprocesos de la canalización. Sin embargo, no serializan elementos de trabajo. Una cola de trabajo serie permite a la aplicación obtener las ventajas del grupo de subprocesos, sin necesidad de realizar la serialización manual de sus propios elementos de trabajo.

Modo de respuesta

Una cola de serializador también puede funcionar en modo de "respuesta". Si el método IMFAsyncCallback::GetParameters del autor de la llamada devuelve la marca MFASYNC_REPLY_CALLBACK , la cola del serializador no avanza automáticamente al siguiente elemento de trabajo. En su lugar, la cola espera una respuesta del autor de la llamada. El autor de la llamada señala la respuesta invocando el objeto de resultado asincrónico que la cola de trabajo pasa al método Invoke . En el código siguiente se muestra cómo el autor de la llamada señala la cola de trabajo. 
HRESULT CCallback::Invoke(IMFAsyncResult *pResult)
{
    DoSomeWork();
    
    // Reply to the work queue that you are done.
    MFInvokeCallback(pResult);

    // Note: This call to MFInvokeCallback does not have to occur inside the
    // Invoke method. You could call MFInvokeCallback at a later time. 

    return S_OK;
}
HRESULT CCallback::GetParameters(DWORD *pdwFlags, DWORD *pdwQueue)
{
    *pdwFlags = MFASYNC_REPLY_CALLBACK;
    *pdwQueue = m_QueueId;
    return S_OK;
}

Requisitos

   
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 mfapi.h
Archivo DLL Mfplat.dll

Consulte también

Funciones de Media Foundation

Mejoras en la cola de trabajo y los subprocesos