KSEVENT 結構

發行項
02/12/2024

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

KSEVENT、KSMETHOD 和 KSPROPERTY 結構是 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.h、 ksmedia.h、 bdamedia.h，以及其他頭檔。

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