KsDiscardEvent 函式 (ks.h)
KsDiscardEvent 函式會捨棄物件取值之後,事件專案所使用的記憶體。 藉由呼叫 KsFreeEventList 函式來停用事件,以停用事件) ,手動停用事件擁有者 (時,可以呼叫 函式。 例如,在異步啟用事件失敗且需要捨棄事件專案時,可以呼叫 函式。
語法
KSDDKAPI VOID KsDiscardEvent(
[in] PKSEVENT_ENTRY EventEntry
);
參數
[in] EventEntry
指定要捨棄之專案的指標。 成功呼叫此函式之後,這個指標就不再有效。
傳回值
無
備註
一般而言,當要求停用事件時,KsDisableEvent 函式會自動呼叫 KsDiscardEvent 函式,或在要求釋放事件清單時由 KsFreeEventList 函式呼叫。 此函式只能在PASSIVE_LEVEL呼叫。
規格需求
需求 | 值 |
---|---|
目標平台 | Universal |
標頭 | ks.h (包含 Ks.h) |
程式庫 | Ks.lib |