Функция KsCreateDefaultClock (ks.h)
При выполнении запроса IRP_MJ_CREATE функция KsCreateDefaultClock создает часы по умолчанию, которые используют системные часы в качестве базы времени и связывает IoGetCurrentIrpStackLocation(Irp)->FileObject с часами с помощью внутренней таблицы диспетчеризации (KSDISPATCH_TABLE). Не завершает IRP или не задает состояние в IRP.
Функцию KsCreateDefaultClock можно вызывать только в PASSIVE_LEVEL.
Синтаксис
KSDDKAPI NTSTATUS KsCreateDefaultClock(
[in] PIRP Irp,
[in] PKSDEFAULTCLOCK DefaultClock
);
Параметры
[in] Irp
Указывает IRP с обрабатываемым запросом clock-create.
[in] DefaultClock
Указывает структуру инициализации часов по умолчанию, которая является общей для любого экземпляра часов по умолчанию для родительского элемента.
Возвращаемое значение
Функция KsCreateDefaultClock возвращает STATUS_SUCCESS в случае успешного выполнения или ошибку в случае неудачи.
Комментарии
Часы можно создать после использования KsAllocateDefaultClock для создания и инициализации внутренних структур для экземпляра часов по умолчанию. После инициализации можно создать множество файлов для одного и того же базового экземпляра часов по умолчанию.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Универсальное |
| Верхняя часть | ks.h (включая Ks.h) |
| Библиотека | Ks.lib |