TpSetCallbackPriority function (winnt.h)

Specifies the priority of a callback function relative to other work items in the same thread pool.

Syntax

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

Parameters

[in, out] CallbackEnviron

A TP_CALLBACK_ENVIRON structure that defines the callback environment. The TpInitializeCallbackEnviron function returns this structure.

[in] Priority

The priority for the callback relative to other callbacks in the same thread pool. This parameter can be one of the following TP_CALLBACK_PRIORITY enumeration values:

Value Meaning
TP_CALLBACK_PRIORITY_HIGH
The callback should run at high priority.
TP_CALLBACK_PRIORITY_LOW
The callback should run at low priority.
TP_CALLBACK_PRIORITY_NORMAL
The callback should run at normal priority.

Return value

None

Remarks

Higher priority callbacks are guaranteed to be run first by the first available worker thread, but they are not guaranteed to finish before lower priority callbacks.

This function is implemented as an inline function.

Requirements

Requirement Value
Target Platform Windows
Header winnt.h

See also

TpDestroyCallbackEnviron

TpInitializeCallbackEnviron

TpSetCallbackActivationContext

TpSetCallbackCleanupGroup

TpSetCallbackFinalizationCallback

TpSetCallbackLongFunction

TpSetCallbackNoActivationContext

TpSetCallbackPersistent

TpSetCallbackRaceWithDll

TpSetCallbackThreadpool