Funzione CreateUmsCompletionList (winbase.h)

Articolo
03/08/2023

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
ERROR_NOT_ENOUGH_MEMORY	Memoria insufficiente per creare l'elenco di completamento.
ERROR_NOT_SUPPORTED	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)

Vedi anche

DequeueUmsCompletionListItems

EnterUmsSchedulingMode

GetUmsCompletionListEvent