共用方式為


PFNKSADDEVENT 回呼函式 (ks.h)

當客戶端註冊通知事件時,會呼叫AVStream minidriver的 AVStrMiniAddEvent 例程。 此例程是選擇性的。

語法

PFNKSADDEVENT Pfnksaddevent;

NTSTATUS Pfnksaddevent(
  [in] PIRP Irp,
  [in] PKSEVENTDATA EventData,
  [in] _KSEVENT_ENTRY *EventEntry
)
{...}

參數

[in] Irp

指定描述事件新增要求的 IRP。

[in] EventData

KSEVENTDATA 結構的指標,描述此事件的通知方法。

[in] EventEntry

AVStream 產生的 KSEVENT_ENTRY 結構的指標,描述事件觸發方式。

傳回值

AVStrMiniAddEvent 應該傳回STATUS_SUCCESS或已啟用事件的特定錯誤。

言論

如果您沒有提供新增事件處理程式,AVStream 會將事件新增至物件清單。 請參閱AVStream 中的事件處理。

此回呼通常會實作廠商特定的行為,然後呼叫 KsFilterAddEventKsPinAddEvent。 minidriver 會透過呼叫 KsFilterAddEventKsPinAddEvent收到 EventEntry 指標。

minidriver 會在 KSEVENT_ITEM 結構的 AddHandler 成員中指定此例程的位址。 AVStream 中的事件處理 說明 minidriver 如何將這個結構提供給類別驅動程式。

如果 AVStream minidriver 指定 AddHandler 為非 NULL,則 AVStream 不會將專案新增至物件的事件清單。 如果 minidriver 指定 AddHandler,而且不會透過 KsDefaultAddEventHandler()Ks*AddEvent 呼叫,將事件新增至物件的事件清單。

要求

要求 價值
最低支援的用戶端 Microsoft Windows XP 和更新版本的作系統和 DirectX 8.0 和更新版本的 DirectX 版本中提供。
目標平臺 桌面
標頭 ks.h (包括 Ks.h)

另請參閱

AVStrMiniRemoveEvent

KSAUTOMATION_TABLE

KSEVENTDATA

KSEVENT_ENTRY

KSEVENT_ITEM

KsFilterAddEvent

KsFilterGenerateEvents

KsPinAddEvent

KsPinGenerateEvents