Функция AvSetMmThreadCharacteristicsA (avrt.h)

Статья
11/20/2024

Связывает вызывающий поток с указанной задачей.

Синтаксис

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 [только классические приложения]
целевая платформа	Виндоус
заголовка	avrt.h
библиотеки	Avrt.lib
DLL	Avrt.dll

См. также

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

Поделиться через