Функция KsAllocateDefaultClock (ks.h)
Функция KsAllocateDefaultClock выделяет и инициализирует структуру часов по умолчанию.
Синтаксис
KSDDKAPI NTSTATUS KsAllocateDefaultClock(
[out] PKSDEFAULTCLOCK *DefaultClock
);
Параметры
[out] DefaultClock
Задает общую структуру часов по умолчанию, выделенную вызывающим объектом. Текущее время равно нулю, а состояние — KSSTATE_STOP. После успешного выполнения этой процедуры структура, указанная этим указателем, будет содержать ссылку на часы по умолчанию. Возвращаемые данные должны рассматриваться как непрозрачные и зарезервированные для использования системой.
Возвращаемое значение
Функция KsAllocateDefaultClock возвращает STATUS_SUCCESS в случае успешного выполнения или ошибку памяти в случае сбоя.
Комментарии
Внутренний элемент DefaultClock.ReferenceCount инициализируется функцией KsAllocateDefaultClock . Элемент увеличивается и уменьшается по мере того, как каждый DPC уведомления помещается в очередь и завершается. При освобождении структуры элемент используется для определения того, должен ли владелец часов освобождать структуру или же ожидающий DPC должен освобождать ее асинхронно.
Если часы больше не нужны, драйвер должен вызвать KsFreeDefaultClock , чтобы освободить все ресурсы, выделенные для использования с часами.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Универсальное |
| Верхняя часть | ks.h (включая Ks.h) |
| Библиотека | Ks.lib |
| IRQL | PASSIVE_LEVEL |