ksGenerateEventList 函式 (ks.h)
KsGenerateEventList 函式會列舉事件清單,並搜尋要產生的指定事件。
語法
KSDDKAPI VOID KsGenerateEventList(
[in, optional] GUID *Set,
[in] ULONG EventId,
[in] PLIST_ENTRY EventsList,
[in] KSEVENTS_LOCKTYPE EventsFlags,
[in] PVOID EventsLock
);
參數
[in, optional] Set
指定要產生事件的選擇性集合。 如果存在,這個值會與清單中每個事件的設定標識符進行比較。 如果沒有,則會忽略集合標識碼,而且只會在比較清單中比對事件時使用特定的事件標識碼。 當已知所有事件都包含在單一集合中時,此比較可節省時間。
[in] EventId
指定要在清單上尋找的特定事件識別碼。
[in] EventsList
指向可找到事件之KSEVENT_ENTRY專案清單的前端。
[in] EventsFlags
指定KSEVENTS_LOCKTYPE旗標 , 指定要用於存取事件清單的排除鎖定類型。 如果未設定旗標,則不會取得鎖定。
[in] EventsLock
用來同步存取清單上的專案。 列舉清單之前會先取得鎖定,並在列舉之後釋放。
傳回值
無
備註
如果鎖定機制允許此函式,則可以在任何 IRQL 層級呼叫此函式。
規格需求
需求 | 值 |
---|---|
目標平台 | Universal |
標頭 | ks.h (包含 Ks.h) |
程式庫 | Ks.lib |
IRQL | 任何層級 (請參閱一節) |