Функция KsDiscardEvent (ks.h)
Функция KsDiscardEvent удаляет память, используемую записью события после разыменования объектов. Функция может вызываться при ручном отключении событий, которые не были отключены владельцем события (путем вызова функции KsFreeEventList для отключения событий). Например, функцию можно вызвать, когда асинхронное включение события завершается сбоем и запись события необходимо отменить.
Синтаксис
KSDDKAPI VOID KsDiscardEvent(
[in] PKSEVENT_ENTRY EventEntry
);
Параметры
[in] EventEntry
Указывает указатель на отбрасываемую запись. Этот указатель больше недействителен после успешного вызова этой функции.
Возвращаемое значение
None
Remarks
Как правило, функция KsDiscardEvent автоматически вызывается функцией KsDisableEvent при запросе на отключение события или функцией KsFreeEventList при запросе на освобождение списка событий. Эту функцию можно вызывать только в PASSIVE_LEVEL.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Универсальное |
| Верхняя часть | ks.h (включая Ks.h) |
| Библиотека | Ks.lib |