Функция KsCreateDefaultClock (ks.h)

Статья
02/26/2024

При выполнении запроса 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

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

KsAllocateDefaultClock

Share via