AvSetMmThreadCharacteristicsA 函数 (avrt.h)
将调用线程与指定的任务相关联。
语法
AVRTAPI HANDLE AvSetMmThreadCharacteristicsA(
[in] LPCSTR TaskName,
[in, out] LPDWORD TaskIndex
);
参数
[in] TaskName
要执行的任务的名称。 此名称必须与 以下项HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Multimedia\SystemProfile\Tasks的某个子项的名称匹配。
[in, out] TaskIndex
唯一的任务标识符。 首次调用此函数时,输入时此值必须为 0。 索引值在输出时返回,并可用作后续调用中的输入。
返回值
如果函数成功,它将返回任务的句柄。
如果函数失败,则返回 0。 若要检索扩展的错误信息,请调用 GetLastError。
下面是可能的错误代码。
返回代码 | 说明 |
---|---|
|
第一次调用时 TaskIndex 不是 0,或者在后续调用) (未识别值。 |
|
指定的任务与注册表中存储的任何任务都不匹配。 |
|
调用方没有足够的权限。 |
注解
任务完成后,调用 AvRevertMmThreadCharacteristics 函数。
注意
avrt.h 标头将 AvSetMmThreadCharacteristics 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | avrt.h |
Library | Avrt.lib |
DLL | Avrt.dll |