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 标头将 AvSetMmMaxThreadCharacteristics 定义为基于 UNICODE 预处理器常量定义自动选择此函数的 ANSI 或 Unicode 版本的别名。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2008 [仅限桌面应用]
目标平台 窗户
标头 avrt.h
Avrt.lib
DLL Avrt.dll

另请参阅

多媒体类计划程序服务