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 呼叫,將事件新增至物件的事件清單。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Microsoft Windows XP 和更新版本的作系統和 DirectX 8.0 和更新版本的 DirectX 版本中提供。 |
目標平臺 | 桌面 |
標頭 | ks.h (包括 Ks.h) |