KSEVENT 結構

KSEVENT結構會指定內核串流事件集內的單一內核串流事件。

KSEVENTKSMETHODKSPROPERTY結構是KSIDENTIFIER結構的別名。 因此,其定義完全相同。

語法

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

成員

Set

指定可識別核心串流事件集的 GUID。

如需事件集 Guid 的詳細資訊,請參閱下面的「 備註 」一節。

Id

指定事件集的成員。

Flags

指定要求類型。

此旗標應該是下表所列的其中一個值。

說明
KSEVENT_TYPE_ENABLE 啟用此事件種類的事件通知。 驅動程式會繼續進行事件通知,直到用戶端明確停用它。
KSEVENT_TYPE_ONESHOT 只針對下一次出現的此事件啟用事件通知。 用戶端不需要 (,也不應該在事件發生時) 停用該事件。
KSEVENT_TYPE_SETSUPPORT 查詢事件集清單,或針對特定事件集的支援。
KSEVENT_TYPE_BASICSUPPORT 支援特定事件種類的查詢。
KSEVENT_TYPE_ENABLEBUFFERED 驅動程式會將事件通知排在佇列中,而不是通知用戶端。 然後,用戶端會發出第二個 IOCTL_KS_ENABLE_EVENT 要求,並使用 KSEVENT_TYPE_QUERYBUFFER 來接收佇列的事件通知。
KSEVENT_TYPE_TOPOLOGY 指出傳遞的事件屬於類型 KSE_NODE,其中節點 識別碼表示拓撲節點的數值識別碼。 請勿自行設定此旗標;相反地,或與此清單中的其他旗標搭配使用。
KSEVENT_TYPE_QUERYBUFFER 抓取下一個緩衝的事件通知。

備註

Microsoft 提供數個系統定義的事件集 Guid。 Minidrivers 指定 集合 成員中的其中一個 guid。 核心串流事件集通常以 KSEVENTSETID 前置詞開頭。 核心串流事件集定義于 ksksmedia .hbdamedia,以及可能的其他標頭檔中。

如需內核串流事件的詳細資訊,請參閱 KS 屬性、事件和方法

規格需求

標頭: ks (包含 ks)

另請參閱

KSE_NODE

KSIDENTIFIER

KSMETHOD

KSPROPERTY