Share via

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。

以下是可能的錯誤碼。

傳回碼 Description
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 [僅限傳統型應用程式]
目標平台 Windows
標頭 avrt.h
程式庫 Avrt.lib
Dll Avrt.dll

另請參閱

多媒體類別排程器服務