PFNKSREMOVEEVENT 回呼函式 (ks.h)

發行項
02/29/2024

當用戶端要求從事件的通知佇列中移除時，會呼叫AVStream minidriver的 AVStrMiniRemoveEvent 例程。此例程是選擇性的。

語法

PFNKSREMOVEEVENT Pfnksremoveevent;

void Pfnksremoveevent(
  [in] PFILE_OBJECT FileObject,
  [in] _KSEVENT_ENTRY *EventEntry
)
{...}

參數

[in] FileObject

要移除事件的檔案物件的指標。

[in] EventEntry

AVStream 產生的 KSEVENT_ENTRY 結構的指標。

傳回值

無

備註

minidriver 會在 KSEVENT_ITEM 結構的 RemoveHandler 成員中指定這個例程的位址。 AVStream 中的事件處理描述迷你驅動程式如何將這個結構提供給類別驅動程式。

如果 minidriver 提供 AVStrMiniRemoveEvent，而且未指定 AddHandler 或指定呼叫 KsXxxAddEvent 的 AddHandler，則 minidriver 的 AVStrMiniRemoveEvent 必須以指向 KSEVENT_ENTRY 結構中的 LIST_ENTRY 結構的指標呼叫 RemoveEntryList：

&EventEntry -> ListEntry

否則， AVStrMiniRemoveEvent 應該反轉 AddHandler 中採取的步驟。

規格需求

需求	值
最低支援的用戶端	適用於 Microsoft Windows XP 和更新版本的作業系統和 DirectX 8.0 和更新版本的 DirectX。
目標平台	桌面
標頭	ks.h (包含 Ks.h)