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)