SetThreadpoolCallbackPriority 関数 (winbase.h)

  • [アーティクル]

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

構文

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

パラメーター

[in, out] pcbe

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

[in] Priority

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

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

戻り値

なし

解説

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

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

この関数を使用するアプリケーションをコンパイルするには、_WIN32_WINNT >= _WIN32_WINNT_WIN7を設定します。 詳細については、「 Windows ヘッダーの使用」を参照してください。

要件

   
サポートされている最小のクライアント Windows 7 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー winbase.h (Windows.h を含む)