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