Funzione SetThreadpoolCallbackPriority (winbase.h)

  • Articolo

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)