Funzione CreateUmsCompletionList (winbase.h)
Crea un elenco di completamento della pianificazione in modalità utente .UMS.
Avviso
A partire da Windows 11, la pianificazione in modalità utente non è supportata. Tutte le chiamate hanno esito negativo con l'errore ERROR_NOT_SUPPORTED.
Sintassi
BOOL CreateUmsCompletionList(
[out] PUMS_COMPLETION_LIST *UmsCompletionList
);
Parametri
[out] UmsCompletionList
Variabile PUMS_COMPLETION_LIST . Nell'output questo parametro riceve un puntatore a un elenco di completamento UMS vuoto.
Valore restituito
Se la funzione ha esito positivo, restituisce un valore diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError. I valori di errore possibili includono quanto segue.
| Codice restituito | Descrizione |
|---|---|
|
Memoria insufficiente per creare l'elenco di completamento. |
|
UMS non è supportato. |
Commenti
Un elenco di completamento è associato a un thread dell'utilità di pianificazione UMS quando viene chiamata la funzione EnterUmsSchedulingMode per creare il thread dell'utilità di pianificazione. I thread di lavoro di messaggistica unificata appena creati vengono accodato all'elenco di completamento. Accoda anche i thread di lavoro di messaggistica unificata bloccati in precedenza all'elenco di completamento quando i thread non sono più bloccati.
Quando viene chiamata la funzione del punto di ingresso UmsSchedulerProc di un'applicazione, l'utilità di pianificazione dell'applicazione deve recuperare gli elementi dall'elenco di completamento chiamando DequeueUmsCompletionListItems.
Ogni elenco di completamento ha un evento di elenco di completamento associato che viene segnalato ogni volta che le voci di sistema vengono accodate a un elenco vuoto. Utilizzare getUmsCompletionListEvent per ottenere un handle per l'evento per un elenco di completamento specificato.
Quando un elenco di completamento non è più necessario, usare DeleteUmsCompletionList per rilasciare l'elenco. L'elenco deve essere vuoto prima che possa essere rilasciato.
Requisiti
| Client minimo supportato | Windows 7 (solo a 64 bit) [solo app desktop] |
| Server minimo supportato | Windows Server 2008 R2 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winbase.h (include Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |
| Set di API | api-ms-win-core-ums-l1-1-0 (introdotto in Windows 7) |