Функция KsGenerateEvent (ks.h)
Функция KsGenerateEvent создает стандартное уведомление о событии с учетом структуры записи события.
Синтаксис
KSDDKAPI NTSTATUS KsGenerateEvent(
[in] PKSEVENT_ENTRY EventEntry
);
Параметры
[in] EventEntry
Указывает структуру записи событий, которая ссылается на данные события. Сведения используются для определения типа уведомления. Если тип уведомления не является одним из предопределенных стандартов, возвращается ошибка. В случае одного события, не выполняющегося, эта запись будет недопустимой при возвращении из функции. Таким образом, любой код, перечисляющий список событий, должен предварительно увеличиться для получения следующего события в списке перед передачей этого события в функцию.
Возвращаемое значение
Функция KsGenerateEvent возвращает STATUS_SUCCESS в случае успешного выполнения или если ошибка не возвращает исключение или ошибку памяти.
Замечания
Устройство определяет, когда уведомления о событиях создаются с помощью структуры KSEVENT_ENTRY, а затем использует эту функцию для выполнения фактического уведомления. KsGenerateEvent можно вызвать на любой IRQL. При вызове выше DISPATCH_LEVEL сигнал о событии будет выполняться асинхронно в DPC.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Всеобщий |
| заголовка | ks.h (include Ks.h) |
| библиотеки | Ks.lib |
| IRQL | Любой уровень (см. раздел "Примечания") |