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を含む)