KsGenerateEventList-Funktion (ks.h)

Artikel
02/26/2024

Die KsGenerateEventList-Funktion listet die Ereignisliste auf und sucht nach dem angegebenen Ereignis, das generiert werden soll.

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. Falls vorhanden, wird dieser Wert mit dem Setbezeichner für jedes Ereignis in der Liste verglichen. Wenn nicht vorhanden, werden die Setbezeichner ignoriert, und nur der spezifische Ereignisbezeichner wird im Vergleich für übereinstimmende Ereignisse in der Liste verwendet. Dieser Vergleich spart Zeit, wenn bekannt ist, dass alle Ereignisse in einem einzelnen Satz enthalten sind.

[in] EventId

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

[in] EventsList

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

[in] EventsFlags

Gibt das KSEVENTS_LOCKTYPE-Flag an, das den Ausschlusssperrtyp angibt, der beim Zugriff auf die Ereignisliste verwendet werden soll. Wenn kein Flag festgelegt ist, wird keine Sperre genommen.

[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 Enumeration freigegeben.