Función DequeueUmsCompletionListItems (winbase.h)

  • Artículo

Recupera los subprocesos de trabajo de programación en modo de usuario (UMS) de la lista de finalización de UMS especificada.

Advertencia

A partir de Windows 11, no se admite la programación en modo de usuario. Todas las llamadas producen el error ERROR_NOT_SUPPORTED.

Sintaxis

BOOL DequeueUmsCompletionListItems(
  [in]  PUMS_COMPLETION_LIST UmsCompletionList,
  [in]  DWORD                WaitTimeOut,
  [out] PUMS_CONTEXT         *UmsThreadList
);

Parámetros

[in] UmsCompletionList

Puntero a la lista de finalización desde la que se van a recuperar subprocesos de trabajo.

[in] WaitTimeOut

Intervalo de tiempo de espera para la operación de recuperación, en milisegundos. La función devuelve si transcurre el intervalo, incluso si no hay subprocesos de trabajo en cola en la lista de finalización.

Si el parámetro WaitTimeOut es cero, la lista de finalización se comprueba si hay subprocesos de trabajo disponibles sin esperar a que los subprocesos de trabajo estén disponibles. Si el parámetro WaitTimeOut es INFINITE, el intervalo de tiempo de espera de la función nunca transcurre. Sin embargo, esto no se recomienda porque hace que la función se bloquee hasta que uno o varios subprocesos de trabajo estén disponibles.

[out] UmsThreadList

Puntero a una variable UMS_CONTEXT. En la salida, este parámetro recibe un puntero al primer contexto de subproceso de UMS en una lista de contextos de subprocesos de UMS.

Si no hay subprocesos de trabajo disponibles antes del tiempo de espera especificado por el parámetro WaitTimeOut , este parámetro se establece en NULL.

Valor devuelto

Si la función se ejecuta correctamente, devuelve un valor distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError. Entre los valores de error posibles se incluyen los siguientes.

Código devuelto Descripción
ERROR_TIMEOUT
 No hay subprocesos disponibles antes de que haya transcurrido el intervalo de tiempo de espera especificado.
ERROR_NOT_SUPPORTED
 No se admite UMS.

Comentarios

El sistema pone en cola un subproceso de trabajo de UMS en una lista de finalización cuando se crea el subproceso de trabajo o cuando se desbloquea un subproceso de trabajo bloqueado previamente. La función DequeueUmsCompletionListItems recupera un puntero a una lista de todos los contextos de subproceso de la lista de finalización especificada. La función GetNextUmsListItem se puede usar para quitar los contextos de subprocesos de UMS de la lista en la propia cola de subprocesos listos del programador. El programador es responsable de seleccionar subprocesos para ejecutarse en función de las prioridades elegidas por la aplicación.

No ejecute subprocesos de UMS directamente desde la lista proporcionada por DequeueUmsCompletionListItems o ejecute un subproceso transferido de la lista a la cola de subprocesos lista antes de que la lista esté completamente vacía. Esto puede provocar un comportamiento imprevisible en la aplicación.

Si más de un llamador intenta recuperar subprocesos de una lista de finalización compartida, solo el primer llamador recupera los subprocesos. Para los autores de llamadas posteriores, la función DequeueUmsCompletionListItems devuelve correctamente, pero el parámetro UmsThreadList se establece en NULL.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 (solo 64 bits) [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winbase.h (incluya Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll
Conjunto de API api-ms-win-core-ums-l1-1-0 (introducido en Windows 7)

Consulte también

GetNextUmsListItem