Función MFAllocateWorkQueueEx (mfapi.h)

  • Artículo

Crea una nueva cola de trabajo. Esta función amplía las funcionalidades de la función MFAllocateWorkQueue al permitir crear una cola de trabajo que tenga un bucle de mensajes.

Sintaxis

HRESULT MFAllocateWorkQueueEx(
  [in]  MFASYNC_WORKQUEUE_TYPE WorkQueueType,
  [out] DWORD                  *pdwWorkQueue
);

Parámetros

[in] WorkQueueType

Miembro de la enumeración MFASYNC_WORKQUEUE_TYPE , especificando el tipo de cola de trabajo que se va a crear.

Valor Significado
MF_MULTITHREADED_WORKQUEUE
 Cree una cola de trabajo multiproceso. Por lo general, las aplicaciones no deben crear colas multiproceso privadas. En su lugar, use las colas multiproceso de la plataforma. Para obtener más información, consulte Work Queue and Threading Improvements.
MF_STANDARD_WORKQUEUE
 Cree una cola de trabajo sin un bucle de mensajes. El uso de esta marca equivale a llamar a MFAllocateWorkQueue.
MF_WINDOW_WORKQUEUE
 Cree una cola de trabajo con un bucle de mensajes. El subproceso que distribuye los elementos de trabajo de esta cola también llamará a PeekMessage y DispatchMessage. Use esta opción si la devolución de llamada realiza cualquier acción que requiera un bucle de mensajes.

[out] pdwWorkQueue

Recibe un identificador de la cola de trabajo que se creó.

Valor devuelto

La función devuelve un HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

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.
E_INVALIDARG
 Argumento no válido.
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.

La función MFAllocateWorkQueue equivale a llamar a MFAllocateWorkQueueEx con el valor MF_STANDARD_WORKQUEUE para el parámetro WorkQueueType .

Esta función está disponible en Windows Vista si está instalado Platform Update Supplement para Windows Vista.

Requisitos

Requisito Value
Cliente mínimo compatible Complemento de actualización de Windows 7, Windows Vista y plataforma para Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mfapi.h
Library Mfplat.lib
Archivo DLL Mfplat.dll

Consulte también

MFPutWorkItem

MFPutWorkItemEx

Funciones de Media Foundation

Colas de trabajo