共用方式為


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

另請參閱

KsDisableEvent

KsFreeEventList