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 |