SetThreadpoolCallbackPriority-Funktion (winbase.h)

Artikel
08/27/2023

Gibt die Priorität einer Rückruffunktion im Verhältnis zu anderen Arbeitselementen im selben Threadpool an.

Syntax

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

Parameter

[in, out] pcbe

Eine TP_CALLBACK_ENVIRON-Struktur , die die Rückrufumgebung definiert. Die InitializeThreadpoolEnvironment-Funktion gibt diese Struktur zurück.

[in] Priority

Die Priorität für den Rückruf relativ zu anderen Rückrufen im selben Threadpool. Dieser Parameter kann einer der folgenden TP_CALLBACK_PRIORITY Enumerationswerte sein:

Wert	Bedeutung
TP_CALLBACK_PRIORITY_HIGH	Der Rückruf sollte mit hoher Priorität ausgeführt werden.
TP_CALLBACK_PRIORITY_LOW	Der Rückruf sollte mit niedriger Priorität ausgeführt werden.
TP_CALLBACK_PRIORITY_NORMAL	Der Rückruf sollte mit normaler Priorität ausgeführt werden.

Rückgabewert

Keine

Bemerkungen

Rückrufe mit höherer Priorität werden garantiert zuerst vom ersten verfügbaren Workerthread ausgeführt, aber es ist nicht garantiert, dass sie vor Rückrufen mit niedrigerer Priorität abgeschlossen werden.

Diese Funktion wird als Inlinefunktion implementiert.

Um eine Anwendung zu kompilieren, die diese Funktion verwendet, legen Sie _WIN32_WINNT >= _WIN32_WINNT_WIN7 fest. Weitere Informationen finden Sie unter Verwenden der Windows-Header.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (einschließlich Windows.h)

Freigeben über