Función MFAllocateWorkQueueEx (mfapi.h)

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