共用方式為


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

另請參閱

KsDisableEvent

KsFreeEventList