KSEVENT 構造体

KSEVENT 構造体は、カーネル ストリーミング イベント セット内の単一のカーネル ストリーミング イベントを指定します。

KSEVENT、KSMETHOD、および KSPROPERTY 構造体は、KSIDENTIFIER 構造体のエイリアスです。 そのため、それらの定義は同じです。

構文

struct KSEVENT {
  GUID Set;
  ULONG Id;
  ULONG Flags;
};

メンバー

Set

カーネル ストリーミング イベント セットを識別する GUID を指定します。

イベント セット GUID の詳細については、以下の「備考」セクションを参照してください。

Id

イベント セットのメンバーを指定します。

Flags

要求の種類を指定します。

このフラグは、次の表に示す値のいずれかである必要があります。

Value	説明
KSEVENT_TYPE_ENABLE	このイベントの種類のイベント通知を有効にします。 ドライバーは、クライアントが明示的に無効になるまでイベント通知を続行します。
KSEVENT_TYPE_ONESHOT	このイベントの次の発生に対してのみイベント通知を有効にします。 クライアントは、イベントが発生した後はそれを無効にする必要はありません (また、無効しないでください)。
KSEVENT_TYPE_SETSUPPORT	イベント セットの一覧または特定のイベント セットのサポートに対するクエリ。
KSEVENT_TYPE_BASICSUPPORT	特定のイベントの種類をサポートするためのクエリ。
KSEVENT_TYPE_ENABLEBUFFERED	ドライバーは、クライアントに通知するのではなく、イベント通知をキューに入れます。 その後、クライアントは、キューに登録されたイベント通知を受信するために、KSEVENT_TYPE_QUERYBUFFER に対して 2 番目の IOCTL_KS_ENABLE_EVENT 要求を発行します。
KSEVENT_TYPE_TOPOLOGY	渡されたイベントが KSE_NODE 種類であることを示します。NodeId はトポロジ ノードの数値 ID を示します。 このフラグは単独で設定しないでください。代わりに、このリストの他のフラグを指定します。
KSEVENT_TYPE_QUERYBUFFER	バッファーに格納された次のイベント通知を取得します。

解説

Microsoft は、いくつかのシステム定義イベント セット GUID を提供しています。 ミニドライバーは、セット メンバーでこれらの GUID のいずれかを指定します。 カーネル ストリーミング イベント セットは、通常、KSEVENTSETID プレフィックスで始まります。 カーネル ストリーミング イベント セットは、ks.h、ksmedia.h、bdamedia.h、および場合によっては他のヘッダー ファイルで定義されます。

カーネル ストリーミング イベントの詳細については、「KS のプロパティ、イベント、およびメソッド」を参照してください。

要件

ヘッダー: ks.h (Ks.hを含む)

関連項目

KSE_NODE

KSIDENTIFIER

KSMETHOD

KSPROPERTY