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。 它不會假設呼叫端是事件擁有者。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 標頭 | ks.h (包含 Ks.h) |
| 程式庫 | Ks.lib |