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