共用方式為

AvSetMmMaxThreadCharacteristicsA 函式 （avrt.h）

  • 發行項

將呼叫線程與指定的工作產生關聯。

語法

AVRTAPI HANDLE AvSetMmMaxThreadCharacteristicsA(
  [in]      LPCSTR  FirstTask,
  [in]      LPCSTR  SecondTask,
  [in, out] LPDWORD TaskIndex
);

參數

[in] FirstTask

要執行之第一個工作的名稱。 此名稱必須符合下列其中一個索引鍵的子機碼名稱，HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Multimedia\SystemProfile\Tasks。

[in] SecondTask

要執行之第二個工作的名稱。 此名稱必須符合下列其中一個索引鍵的子機碼名稱，HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Multimedia\SystemProfile\Tasks。

[in, out] TaskIndex

唯一的工作標識碼。 第一次呼叫此函式時，這個值在輸入上必須是 0。 索引值會在輸出上傳回，而且可在後續呼叫中當做輸入使用。

傳回值

如果函式成功，它會傳回工作的句柄。

如果函式失敗，則會傳回 0。 若要擷取擴充的錯誤資訊，請呼叫 GetLastError。

以下是可能的錯誤碼。

傳回碼 描述
ERROR_INVALID_TASK_INDEX
 TaskIndex 在第一次呼叫時不是 0，或是在後續呼叫時無法辨識值。
ERROR_INVALID_TASK_NAME
 指定的工作不符合登錄中儲存的任何工作。
ERROR_PRIVILEGE_NOT_HELD
 呼叫端沒有足夠的許可權。

言論

執行工作之線程所產生的特性會反映優先順序最高的工作。

當工作完成時，請呼叫 AvRevertMmThreadCharacteristics 函式。

注意

avrt.h 標頭會根據 UNICODE 預處理器常數的定義，將 AvSetMmMaxThreadCharacteristics 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 avrt.h
連結庫 Avrt.lib
DLL Avrt.dll

另請參閱

多媒體類別排程器服務