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中的事件處理。
此回呼通常會實作廠商特定的行為，然後呼叫 KsFilterAddEvent 或 KsPinAddEvent。 minidriver 會在呼叫 KsFilterAddEvent 或 KsPinAddEvent 時傳遞這裡收到的 EventEntry 指標。
minidriver 會在 KSEVENT_ITEM 結構的 AddHandler 成員中指定此例程的位址。 AVStream 中的事件處理 描述 minidriver 如何將這個結構提供給類別驅動程式。
如果 AVStream minidriver 將 AddHandler 指定為非 NULL，AVStream 就不會將專案新增至物件的事件清單。 如果 minidriver 指定 AddHandler ，且不會透過 KsDefaultAddEventHandler () 或 Ks*AddEvent 呼叫，將事件新增至物件的事件清單，則 minidriver 會負責清除事件。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 Microsoft Windows XP 和更新版本的作業系統和 DirectX 8.0 和更新版本的 DirectX 版本。 |
| 目標平台 | 桌面 |
| 標頭 | ks.h (包含 Ks.h) |