Функция 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 | Любой уровень (см. раздел "Примечания") |