Función createUmsCompletionList (winbase.h)
Crea una lista de finalización de programación en modo de usuario (UMS).
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 CreateUmsCompletionList(
[out] PUMS_COMPLETION_LIST *UmsCompletionList
);
Parámetros
[out] UmsCompletionList
Variable PUMS_COMPLETION_LIST . En la salida, este parámetro recibe un puntero a una lista de finalización de UMS vacía.
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 |
|---|---|
|
No hay suficiente memoria disponible para crear la lista de finalización. |
|
No se admite UMS. |
Comentarios
Una lista de finalización está asociada a un subproceso del programador de UMS cuando se llama a la función EnterUmsSchedulingMode para crear el subproceso del programador. El sistema pone en cola los subprocesos de trabajo de UMS recién creados en la lista de finalización. También pone en cola subprocesos de trabajo de UMS bloqueados previamente en la lista de finalización cuando los subprocesos ya no están bloqueados.
Cuando se llama a la función de punto de entrada UmsSchedulerProc de una aplicación, el programador de la aplicación debe recuperar elementos de la lista de finalización llamando a DequeueUmsCompletionListItems.
Cada lista de finalización tiene un evento de lista de finalización asociado que se señala cada vez que el sistema pone en cola los elementos de una lista vacía. Use GetUmsCompletionListEvent para obtener un identificador para el evento de una lista de finalización especificada.
Cuando ya no se necesite una lista de finalización, use DeleteUmsCompletionList para liberar la lista. La lista debe estar vacía antes de que se pueda liberar.
Requisitos
| 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) |