KSEVENT_ITEM 結構 (ks.h)

  • 發行項

KSEVENT_ITEM結構描述迷你驅動程式對事件集內特定事件的支援。

語法

typedef struct {
  ULONG            EventId;
  ULONG            DataInput;
  ULONG            ExtraEntryData;
  PFNKSADDEVENT    AddHandler;
  PFNKSREMOVEEVENT RemoveHandler;
  PFNKSHANDLER     SupportHandler;
} KSEVENT_ITEM, *PKSEVENT_ITEM;

成員

EventId

指定事件集內事件的唯一標識碼。

DataInput

指定事件數據位元組的大小。 事件數據會以 KSEVENTDATA 結構開頭，描述用戶端在事件發生時應如何收到通知，選擇性地接著指定事件發生時間的任何其他參數。 必須至少 (KSEVENTDATA) 大小 。

ExtraEntryData

指定系統應該為這個事件的每個啟用要求配置的任何其他記憶體大小，以位元組為單位。 驅動程式會使用此記憶體來儲存需要追蹤事件要求的任何數據。 記憶體會直接配置在事件啟用要求的 KSEVENT_ENTRY 結構之後。

AddHandler

迷你驅動程式提供的 AVStrMiniAddEvent 回呼例程的指標。 數據流類別驅動程式未使用。 僅適用於AVStream迷你驅動程式。

RemoveHandler

minidriver 提供的 AVStrMiniRemoveEvent 回呼例程的指標。 數據流類別驅動程式未使用。 僅適用於AVStream迷你驅動程式。

SupportHandler

數據流類別驅動程式未使用。

備註

指定 AddHandler 和 RemoveHandler 成員且未正確清除事件的迷你驅動程式，可能會導致資源 (記憶體/句柄) 流失。

規格需求

需求 值
標頭 ks.h (包含 Ks.h)

另請參閱

IOCTL_KS_DISABLE_EVENT

KSEVENTDATA

KSEVENT_ENTRY

KsDefaultAddEventHandler