KsFreeEventList 函式 （ks.h）
KsFreeEventList 函式會處理從指定清單中釋放所有事件，並假設這些事件是由 KSEVENT_ENTRY 結構所組成。 此函式只能在PASSIVE_LEVEL呼叫。
語法
KSDDKAPI VOID KsFreeEventList(
[in] PFILE_OBJECT FileObject,
[in, out] PLIST_ENTRY EventsList,
[in] KSEVENTS_LOCKTYPE EventsFlags,
[in] PVOID EventsLock
);
參數
[in] FileObject
指定傳遞至移除函式之內容資訊的檔案物件。 相關聯的檔案物件可用來與啟用事件時原本指定的檔案對象進行比較。 這可讓單一事件清單用於以檔案物件區分的多個用戶端。
[in, out] EventsList
指向要釋放之KSEVENT_ENTRY專案清單的標頭。 如果清單中有任何事件目前正在停用，則會傳遞這些事件。 如果在處理時將任何新元素新增至清單，則可能不會釋出它們。
[in] EventsFlags
指定 KSEVENTS_LOCKTYPE 旗標，指定要用於存取事件清單的排除鎖定類型。 如果未設定旗標，則不會取得鎖定。
[in] EventsLock
用來同步處理清單上元素的存取。 存取項目之後，會將其標示為已刪除，因此後續移除要求會失敗。 然後在呼叫移除函式之後釋放鎖定，如果有的話。 拿掉函式必須與事件產生同步處理，才能實際從清單中移除專案。
傳回值
沒有
言論
KsFreeEventList 函式會呼叫 remove 處理程式，然後針對每個事件呼叫 KsDiscardEvent。 它不會假設呼叫端是事件擁有者。
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 普遍 |
| 標頭 | ks.h （包括 Ks.h） |
| 連結庫 | Ks.lib |