Funzione SetThreadpoolCallbackPriority (winbase.h)

Articolo
08/27/2023

Specifica la priorità di una funzione di callback rispetto ad altri elementi di lavoro nello stesso pool di thread.

Sintassi

void SetThreadpoolCallbackPriority(
  [in, out] PTP_CALLBACK_ENVIRON pcbe,
  [in]      TP_CALLBACK_PRIORITY Priority
);

Parametri

[in, out] pcbe

Struttura TP_CALLBACK_ENVIRON che definisce l'ambiente di callback. La funzione InitializeThreadpoolEnvironment restituisce questa struttura.

[in] Priority

Priorità per il callback rispetto ad altri callback nello stesso pool di thread. Questo parametro può essere uno dei valori di enumerazione seguenti TP_CALLBACK_PRIORITY :

Valore	Significato
TP_CALLBACK_PRIORITY_HIGH	Il callback deve essere eseguito con priorità elevata.
TP_CALLBACK_PRIORITY_LOW	Il callback deve essere eseguito con priorità bassa.
TP_CALLBACK_PRIORITY_NORMAL	Il callback deve essere eseguito con priorità normale.

Valore restituito

nessuno

Osservazioni

I callback con priorità superiore sono garantiti per essere eseguiti prima dal primo thread di lavoro disponibile, ma non sono garantiti di completare prima dei callback con priorità inferiore.

Questa funzione viene implementata come funzione inline.

Per compilare un'applicazione che usa questa funzione, impostare _WIN32_WINNT = _WIN32_WINNT_WIN7 >. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Requisiti


Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)

Condividi tramite