KsGenerateEvent 関数 (ks.h)

KsGenerateEvent 関数は、イベント エントリ構造を指定して標準イベント通知を生成します。

構文

KSDDKAPI NTSTATUS KsGenerateEvent(
  [in] PKSEVENT_ENTRY EventEntry
);

パラメーター

[in] EventEntry

イベント データを参照するイベント エントリ構造を指定します。 この情報は、実行する通知の種類を決定するために使用されます。 通知の種類が定義済みの標準の 1 つでない場合は、エラーが返されます。 単一の非回復イベントの場合、このエントリは関数から戻ると無効になります。 そのため、イベントの一覧を列挙するコードは、このイベントを関数に渡す前に、リスト内の次のイベントを取得するために事前に作成する必要があります。

戻り値

KsGenerateEvent 関数は、成功した場合、または失敗した場合は例外またはメモリ エラーを返STATUS_SUCCESSを返します。

備考

デバイスは、KSEVENT_ENTRY 構造を使用してイベント通知が生成されるタイミングを決定し、この関数を使用して実際の通知を実行します。 KsGenerateEvent は、任意の IRQL で呼び出すことができます。 上記DISPATCH_LEVEL呼び出された場合、イベントのシグナル通知は DPC で非同期的に実行されます。

必要条件

要件	価値
ターゲット プラットフォーム の	万国
ヘッダー	ks.h (Ks.h を含む)
ライブラリ	Ks.lib
IRQL	任意のレベル (「解説」セクションを参照)

関連項目

KsFilterAddEvent の

KsFilterGenerateEvents の

KsPinAddEvent の

KsPinGenerateEvents を する