TpSetCallbackPriority-Funktion (winnt.h)

Artikel
08/27/2023

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

Syntax

void TpSetCallbackPriority(
  [in, out] PTP_CALLBACK_ENVIRON CallbackEnviron,
  [in]      TP_CALLBACK_PRIORITY Priority
);

Parameter

[in, out] CallbackEnviron

Eine TP_CALLBACK_ENVIRON-Struktur , die die Rückrufumgebung definiert. Die TpInitializeCallbackEnviron-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 sie werden nicht garantiert vor Rückrufen mit niedrigerer Priorität abgeschlossen.

Diese Funktion wird als Inlinefunktion implementiert.