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

生成するイベントが属するオプションのセットを指定します。 存在する場合、この値はリスト内の各イベントのセット識別子と比較されます。 存在しない場合、セット識別子は無視され、リスト上のイベントを照合するための比較では、特定のイベント識別子だけが使用されます。 この比較により、すべてのイベントが 1 つのセットに含まれていることがわかっている時間が節約されます。

[in] EventId

リストで検索する特定のイベント識別子を指定します。

[in] EventsList

イベントが見つかるKSEVENT_ENTRY項目の一覧の先頭をポイントします。

[in] EventsFlags

イベント リストへのアクセスに使用する除外ロックの種類を指定する KSEVENTS_LOCKTYPE フラグを指定します。 フラグが設定されていない場合、ロックは行われません。

[in] EventsLock

リスト上の要素へのアクセスを同期するために使用されます。 ロックはリストを列挙する前に取得され、列挙後に解放されます。

戻り値

なし

解説

この関数は、ロック メカニズムで許可されている場合は、任意の IRQL レベルで呼び出すことができます。

要件

要件 値
対象プラットフォーム ユニバーサル
Header ks.h (Ks.h を含む)
Library Ks.lib
IRQL 任意のレベル (「解説」セクションを参照)

こちらもご覧ください

KsFilterAddEvent

KsFilterGenerateEvents

KsPinAddEvent

KsPinGenerateEvents