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


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

Функция KsGenerateEvent создает стандартное уведомление о событии с учетом структуры записи события.

Синтаксис

KSDDKAPI NTSTATUS KsGenerateEvent(
  [in] PKSEVENT_ENTRY EventEntry
);

Параметры

[in] EventEntry

Задает структуру записи события, которая ссылается на данные события. Сведения используются для определения типа уведомления. Если тип уведомления не является одним из предопределенных стандартов, возвращается ошибка. В случае одного события nonrecurring эта запись будет недопустимой при возвращении из функции. Поэтому любой код, перечисляющий список событий, должен предварительно увеличиваться, чтобы получить следующее событие в списке перед передачей этого события в функцию.

Возвращаемое значение

Функция KsGenerateEvent возвращает STATUS_SUCCESS в случае успешного выполнения или в случае неудачи возвращает исключение или ошибку памяти.

Комментарии

Устройство определяет, когда создаются уведомления о событиях с помощью структуры KSEVENT_ENTRY , а затем использует эту функцию для выполнения фактического уведомления. KsGenerateEvent можно вызвать в любом IRQL. При вызове выше DISPATCH_LEVEL сигнал о событии будет выполняться асинхронно в DPC.

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть ks.h (включая Ks.h)
Библиотека Ks.lib
IRQL Любой уровень (см. раздел "Примечания")

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

KsFilterAddEvent

KsFilterGenerateEvents

KsPinAddEvent

KsPinGenerateEvents