KsDiscardEvent 函数 (ks.h)

KsDiscardEvent 函数在取消引用对象后放弃事件项使用的内存。 通过调用 KsFreeEventList 函数来禁用事件, (手动禁用事件所有者) 禁用事件时,可以调用 函数。 例如,当异步启用事件失败并且需要放弃事件条目时,可以调用 函数。

语法

KSDDKAPI VOID KsDiscardEvent(
  [in] PKSEVENT_ENTRY EventEntry
);

参数

[in] EventEntry

指定指向要丢弃的项的指针。 成功调用此函数后,此指针不再有效。

返回值

备注

通常, KsDiscardEvent 函数在发生禁用事件的请求时由 KsDisableEvent 函数自动调用,或者在发生释放事件列表的请求时由 KsFreeEventList 函数自动调用。 只能在PASSIVE_LEVEL调用此函数。

要求

要求
目标平台 通用
标头 ks.h (包括 Ks.h)
Library Ks.lib

另请参阅

KsDisableEvent

KsFreeEventList