KsGenerateEvent 関数 (ks.h)
KsGenerateEvent 関数は、イベント エントリ構造を指定して標準イベント通知を生成します。
構文
KSDDKAPI NTSTATUS KsGenerateEvent(
[in] PKSEVENT_ENTRY EventEntry
);
パラメーター
[in] EventEntry
イベント データを参照するイベント エントリ構造を指定します。 この情報は、実行する通知の種類を決定するために使用されます。 通知の種類が定義済みの標準の 1 つでない場合は、エラーが返されます。 単一の非回復イベントの場合、このエントリは関数から返されると無効になります。 したがって、イベントの一覧を列挙するコードは、このイベントを関数に渡す前に、リスト内の次のイベントを取得するために事前作成する必要があります。
戻り値
KsGenerateEvent 関数は、成功した場合はSTATUS_SUCCESSを返し、失敗した場合は例外またはメモリ エラーを返します。
注釈
デバイスは、 KSEVENT_ENTRY 構造体を使用してイベント通知が生成されるタイミングを決定し、この関数を使用して実際の通知を実行します。 KsGenerateEvent は、任意の IRQL で呼び出すことができます。 DISPATCH_LEVELの上で呼び出された場合、イベントのシグナリングは DPC で非同期的に実行されます。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| Header | ks.h (Ks.h を含む) |
| Library | Ks.lib |
| IRQL | 任意のレベル (「解説」セクションを参照) |