KsGenerateEventList-Funktion (ks.h)

Artikel
02/07/2025

Die KsGenerateEventList--Funktion listet die Ereignisliste auf und sucht nach dem zu generierenden Ereignis.

Syntax

KSDDKAPI VOID KsGenerateEventList(
  [in, optional] GUID              *Set,
  [in]           ULONG             EventId,
  [in]           PLIST_ENTRY       EventsList,
  [in]           KSEVENTS_LOCKTYPE EventsFlags,
  [in]           PVOID             EventsLock
);

Parameter

[in, optional] Set

Gibt einen optionalen Satz an, zu dem das zu generierende Ereignis gehört. Wenn vorhanden, wird dieser Wert mit dem Satzbezeichner für jedes Ereignis in der Liste verglichen. Wenn nicht vorhanden, werden die Satzbezeichner ignoriert, und nur der spezifische Ereignisbezeichner wird im Vergleich für übereinstimmende Ereignisse in der Liste verwendet. Dieser Vergleich spart Zeit, wenn alle Ereignisse in einem einzigen Satz enthalten sind.

[in] EventId

Gibt den spezifischen Ereignisbezeichner an, nach dem in der Liste gesucht werden soll.

[in] EventsList

Verweist auf den Kopf der Liste der KSEVENT_ENTRY Elemente, auf denen das Ereignis gefunden werden kann.

[in] EventsFlags

Gibt das KSEVENTS_LOCKTYPE Flag an, das den Ausschlusssperrtyp angibt, der für den Zugriff auf die Ereignisliste verwendet werden soll. Wenn keine Kennzeichnung festgelegt ist, wird keine Sperre übernommen.

[in] EventsLock

Wird verwendet, um den Zugriff auf ein Element in der Liste zu synchronisieren. Die Sperre wird vor dem Aufzählen der Liste und nach der Aufzählung freigegeben.