Функция 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.

Ниже приведены возможные коды ошибок.

Код возврата Описание
ERROR_INVALID_TASK_INDEX
Значение TaskIndex не равно 0 при первом вызове или не распознается (при последующих вызовах).
ERROR_INVALID_TASK_NAME
Указанная задача не соответствует ни одной из задач, хранящихся в реестре.
ERROR_PRIVILEGE_NOT_HELD
Вызывающий объект не имеет достаточных привилегий.

Комментарии

После завершения задачи вызовите функцию AvRevertMmThreadCharacteristics .

Примечание

Заголовок avrt.h определяет AvSetMmThreadCharacteristics в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header avrt.h
Библиотека Avrt.lib
DLL Avrt.dll

См. также раздел

Служба мультимедийного планировщика классов