共用方式為

AvSetMmThreadCharacteristicsW 函式 (avrt.h)

  • 發行項

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

語法

AVRTAPI HANDLE AvSetMmThreadCharacteristicsW(
  [in]      LPCWSTR TaskName,
  [in, out] LPDWORD TaskIndex
);

參數

[in] TaskName

要執行的工作名稱。 這個名稱必須符合下列索引鍵的其中一個子機碼名稱 ，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 標頭會將AvSetMmThreadCharacteristics定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 avrt.h
程式庫 Avrt.lib
Dll Avrt.dll

另請參閱

多媒體類別排程器服務