TpSetCallbackPriority 関数 (winnt.h)

同じスレッド プール内の他の作業項目に対する相対的なコールバック関数の優先度を指定します。

構文

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

パラメーター

[in, out] CallbackEnviron

コールバック環境を定義する TP_CALLBACK_ENVIRON 構造体。 TpInitializeCallbackEnviron 関数は、この構造体を返します。

[in] Priority

同じスレッド プール内の他のコールバックに対する相対的なコールバックの優先順位。 このパラメーターには、次の TP_CALLBACK_PRIORITY 列挙値のいずれかを指定できます。

説明
TP_CALLBACK_PRIORITY_HIGH
コールバックは高い優先度で実行する必要があります。
TP_CALLBACK_PRIORITY_LOW
コールバックは低優先度で実行する必要があります。
TP_CALLBACK_PRIORITY_NORMAL
コールバックは通常の優先度で実行する必要があります。

戻り値

なし

解説

優先度の高いコールバックは、最初に使用可能なワーカー スレッドによって最初に実行されることは保証されますが、優先順位の低いコールバックの前に完了することは保証されません。

この関数はインライン関数として実装されます。

要件

   
対象プラットフォーム Windows
ヘッダー winnt.h

関連項目

TpDestroyCallbackEnviron

TpInitializeCallbackEnviron

TpSetCallbackActivationContext

TpSetCallbackCleanupGroup

TpSetCallbackFinalizationCallback

TpSetCallbackLongFunction

TpSetCallbackNoActivationContext

TpSetCallbackPersistent

TpSetCallbackRaceWithDll

TpSetCallbackThreadpool