共用方式為


KSEVENT 結構

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

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

語法

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

成員

Set

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

For more information about event set GUIDs, see the Remarks section below.

Id

指定事件集的成員。

Flags

指定要求類型。

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

Description
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,其中 NodeId 表示拓撲節點的數值識別碼。 請勿自行設定此旗標;相反地,或此清單中的其他旗標。
KSEVENT_TYPE_QUERYBUFFER 擷取下一個緩衝事件通知。

備註

Microsoft 提供數個系統定義的事件集 GUID。 Minidrivers 會在 Set 成員中指定其中一個 GUID。 核心串流事件集通常會以 KSEVENTSETID 前置詞開頭。 核心串流事件集定義於 ks.hksmedia.hbdamedia.h,以及其他頭檔。

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

規格需求

標頭: ks.h (包含 Ks.h)

另請參閱

KSE_NODE

KSIDENTIFIER

KSMETHOD

KSPROPERTY