//Прототип C:

unsigned int VDK_GetClockFrequency (void);

//Прототип C++:

unsigned int VDK::GetClockFrequency (void);

Возвращает тактовую частоту (в мегагерцах). Значение частоты указывается как часть конфигурации проекта VDK, и это значение можно поменять runtime вызовом функции SetClockFrequency(). В зоне ответственности разработчика гарантировать соответствие этой частоты используемому аппаратному обеспечению. Функция GetClockFrequency не вовлекает планировщик, и время выполнения этой функции фиксированное.

Примечание: реальное значение тактовой частоты процессора может не соответствовать значению, которое вернет функция GetClockFrequency. Например, если использовался библиотечный модуль управления питанием системных служб (services.h), и частота процессора была установлена вызовом функции adi_pwr_Init, то реальную частоту CPU и системной шины можно получить вызовом функции adi_pwr_GetFreq.

//Прототип C:

void VDK_SetClockFrequency(unsigned int inFrequency);

//Прототип C++:

void VDK::SetClockFrequency(unsigned int inFrequency);

Установит тактовую частоту в мегагерцах, равной значению параметра inFrequency. Тактирование останавливается, параметры тактирования пересчитываются с использованием новой частоты тактирования, после чего тактирование возобновляется. В зоне ответственности разработчика гарантировать соответствие этой частоты используемому аппаратному обеспечению. Функция GetClockFrequency не вовлекает планировщик, и время выполнения этой функции не определенное.

//Прототип C:

unsigned int VDK_GetContextRecordSize(void);

//Прототип C++:

unsigned int VDK::GetContextRecordSize(void);

Это API применимо только для процессоров Blackfin и SHARC. Функция вернет размер области памяти, требуемой для сохранения информации потоков во время переключения контекста.

Для любых приложений Blackfin, которые вручную выделяют память под стек потока, функция GetContextRecordSize() может использоваться для определения дополнительного количества памяти, которое нужно добавить к размеру стека.

Функция GetContextRecordSize не вызывает запуск планировщика, и её время выполнения фиксировано.

//Прототип C:

unsigned int VDK_GetHeapIndex(VDK_HeapID inHeapID);

//Прототип C++:

unsigned int VDK::GetHeapIndex(VDK::HeapID inHeapID);

Транслирует идентификатор кучи HeapID (как он был сконфигурирован на закладке Kernel окна свойств проекта VDK) в индекс кучи, который можно передать функциям heap_malloc(), heap_calloc(), heap_realloc() и heap_free() [2].

Функция GetHeapIndex не вызывает запуск планировщика, и её время выполнения фиксировано.

Обработка ошибок с применением инструментальной сборки: значение ошибки kInvalidHeapID покажет, что inHeapID является недопустимым идентификатором кучи.

//Прототип C:

void** VDK_GetThreadHandle(void);

//Прототип C++:

void** VDK::GetThreadHandle(void);

Вернет указатель на выделенный указатель данных на поток, определенный пользователем. Этот указатель может быть использован в потоках C или ассемблера для удержания локального состояния потока; например, через него может быть получен доступ к переменным потока (member variables).

Функция GetThreadHandle не вызывает запуск планировщика, и её время выполнения фиксировано.

//Прототип C:
VDK_ThreadID VDK_GetThreadID(void);

//Прототип C++:
VDK::ThreadID VDK::GetThreadID(void);

Вернет идентификатор текущего работающего потока, или вернет VDK_KERNEL_LEVEL_, если функция отработала на уровне ядра. Функция не вызывает запуск планировщика, и её время выполнения фиксировано.

//Прототип C:

unsigned int VDK_GetThreadStackUsage(const VDK_ThreadID inThreadID);

//Прототип C++:

unsigned int VDK::GetThreadStackUsage(const VDK::ThreadID inThreadID);

Получает информацию по максимальному использованию стека указанного потока в момент вызова функции (размер стека будет возвращен в 32-битных словах). Для приложений, которые были собраны с установкой "Full Instrumentation", будет возвращено максимальное использование стека либо с момента создания потока, либо с момента последнего API-вызова InstrumentStack(). Для приложений, которые были собраны не с установкой "Full Instrumentation", информация о стеке потоков по умолчанию недоступна. Таким образом, эта функция не вернет какую-либо значимую информацию в этих случаях, за исключением случая, когда ранее была вызвана функция InstrumentStack() для сбора инструментальной информации по стеку потоков.

Функция GetThreadStackUsage не вызывает запуск планировщика, и её время выполнения не определено.

Обработка ошибок с применением инструментальной сборки: значение ошибки kUnknownThread покажет, что в параметре был передан недопустимый идентификатор потока.

//Прототип C:

unsigned int VDK_GetThreadStack2Usage(const VDK_ThreadID inThreadID);

//Прототип C++:

unsigned int VDK::GetThreadStack2Usage(const VDK::ThreadID inThreadID);

Вернет максимальное используемое пространство стека stack2 для указанного потока в момент вызова функции (размер стека будет возвращен в 32-битных словах). Для приложений, которые были собраны с установкой "Full Instrumentation", будет возвращено максимальное использование стека либо с момента создания потока, либо с момента последнего API-вызова InstrumentStack(). Для приложений, которые были собраны не с установкой "Full Instrumentation", информация о стеке потоков по умолчанию недоступна. Таким образом, эта функция не вернет какую-либо значимую информацию в этих случаях, за исключением случая, когда ранее была вызвана функция InstrumentStack() для сбора инструментальной информации по стеку потоков.

Примечание: это API применимо только к некоторым процессорам, которые используют два стека. В настоящий момент это семейство процессоров ADSP-TSxxx.

Функция GetThreadStack2Usage не вызывает запуск планировщика, и её время выполнения не определено.

Обработка ошибок с применением инструментальной сборки: значение ошибки kUnknownThread покажет, что в параметре был передан недопустимый идентификатор потока.

//Прототип C:

void VDK_InstrumentStack(void);

//Прототип C++:

void VDK::InstrumentStack(void);

Запускает сбор информации по стеку вызвавшего потока, чтобы впоследствии можно было определить максимальный объем стека, который использовал поток. API-вызов GetThreadStackUsage() возвратит максимальное использование стека, для которого был запущен сбор инструментальной информации.

Если использовались библиотеки с полной поддержкой инструментальной информации, то вызывать функцию InstrumentStack не требуется, потому что запуск сбора инструментальной информации осуществляется в момент создания потока. В этом случае InstrumentStack() используется для сброса статистики по стеку, чтобы можно было охватить не используемые в настоящий момент области стека (например, когда надо определить, сколько стека использует выполнение определенной секции кода). Если использовались библиотеки без полной поддержки инструментальной информации, то по умолчанию статистика по сбору инструментальной информации стека не запущена, и нужно использовать InstrumentStack(), чтобы вызовы GetThreadStackUsage() давали корректную информацию.

Функция InstrumentStack не вызывает запуск планировщика, и её время выполнения не определено.

//Прототип C:
VDK_ThreadStatus VDK_GetThreadStatus(const VDK_ThreadID inThreadID);

//Прототип C++:
VDK::ThreadStatus VDK::GetThreadStatus(const VDK::ThreadID inThreadID);

Вернет состояние (одно из значений перечисления) указанного потока. Если поток не существует, то вернет VDK::kUnknown.

Функция GetThreadStatus не вызывает запуск планировщика, и её время выполнения фиксированное.

//Прототип C:

float VDK_GetTickPeriod(void);

//Прототип C++:

float VDK::GetTickPeriod(void);

Вернет значение периода тика приложения в миллисекундах.

Функция GetTickPeriod не вызывает запуск планировщика, и её время выполнения фиксированное.

//Прототип C:

void VDK_SetTickPeriod(float inPeriod);

//Прототип C++:

void VDK::SetTickPeriod(float inPeriod);

Устанавливает период типа в inPeriod миллисекунд. Тактирование останавливается, и параметры тактирования вычисляются заново для новой длительности тика, после чего тактирование возобновляется.

Функция SetTickPeriod не вызывает запуск планировщика, и её время выполнения не определено.

//Прототип C:
VDK_Ticks VDK_GetUptime(void);

//Прототип C++:
VDK::Ticks VDK::GetUptime(void);

Вернет время работы приложения в тиках начиная от момента последнего сброса системы.

Функция GetUptime не вызывает запуск планировщика, и её время выполнения фиксированное.

//Прототип C:
VDK_VersionStruct VDK_GetVersion(void);

//Прототип C++:
VDK::VersionStruct VDK::GetVersion(void);

Вернет текущую версию VDK.

Тип VersionStruct это структура, содержащая 4 целых числа. Числа описывают системные параметры: номер версии VDK API, поддерживаемое семейство процессоров, базовый поддерживаемый процессор и номер сборки.

//Прототип C++:

typedef struct
{
   int mAPIVersion;
   VDK::DSP_Family mFamily;
   VDK::DSP_Product mProduct;
   long mBuildNumber;
} VDK::VersionStruct;

mAPIVersion это целое число в формате 0xMMmmUURR, где MM это главный номер версии (major version number), mm это младший номер версии (minor version number), UU это номер обновления (update number), и RR зарезервировано для будущего использования. Поле mAPIVersion не меняется в любом релизе VisualDSP++, кроме случаев, когда меняется VDK API. Подробнее см. описание типов DSP_Family и DSP_Product.

Примечание: разные процессоры могут использовать общий набор библиотек VDK. По этой причине поле mProduct может не соответствовать процессору в конкретном приложении.

//Прототип C:

void VDK_LogHistoryEvent(VDK_HistoryEnum inEnum, int inValue);

//Прототип C++:

void VDK::LogHistoryEvent(VDK::HistoryEnum inEnum, int inValue);

Добавляет запись в буфер истории (history buffer). Эта функция не выполняет никаких действий, если проект не был линкован на этапе сборки с библиотеками, поддерживающими полную инструментальную информацию (fully instrumented libraries).

Функция LogHistoryEvent не вызывает запуск планировщика, и её время выполнения фиксированное.

Параметр inEnum это значение перечисления, показывающее тип события. Параметр inValue, смысл которого зависит от значения перечисления.

//Прототип C:

void VDK_ReplaceHistorySubroutine (HistoryLoggingFunc inFunc);

//Функция inFunc имеет прототип:

void inFunc(VDK_Ticks inTick,
            const VDK_HistoryEnum inEnum,
            const int inValue,
            const VDK_ThreadID inThreaID);

//Прототип C++:

void VDK::ReplaceHistorySubroutine (HistoryLoggingFunc inFunc);

//Функция inFunc имеет прототип:

void inFunc(VDK::Ticks inTick,
            const VDK::HistoryEnum inEnum,
            const int inValue,
            const VDK::ThreadID inThreaID);

Позволяет заменить механизм VDK для записи истории в лог (VDK history logging) на подпрограмму inFunc, которую определит пользователь.

Из-за того, что механизм записи в лог может быть использован из потока, ядра и обработчика прерывания, функция inFunc должна удовлетворять определенным требованиям (см. секцию "Замена механизма записи в лог истории").

Аргументы, передаваемые в функцию inFunc, являются полями структуры HistoryEvent. VDK устанавливает аргументы для inFunc в следующих регистрах, см. таблицу.

Таблица 3-1. В каких регистрах размещены аргументы подпрограммы записи в лог истории.

Подпрограмма, определенная пользователем, может вызвать VDK_ISRAddHistoryEvent() для добавления событий в кольцевой буфер VDK, чтобы отобразить события в окне VDK History. VDK_ISRAddHistoryEvent() принимает те же самые аргументы, в тех же регистрах, что и inFunc. VDK_ISRAddHistoryEvent() вызывается библиотекой VDK по умолчанию, если не был заменен оригинальный механизм регистрации истории (VDK history mechanism). ReplaceHistorySoubroutine() может быть вызвана в момент старта приложения VDK (из кода startup) или в конструкторе глобальной переменной, и её вызов доступен только при полном наличии инструментальных библиотек в сборке приложения VDK (fully instrumented libraries).

Функция ReplaceHistorySubroutine не вызывает запуск планировщика, и её время выполнения фиксированное.