PFNKSREMOVEEVENT 回调函数 (ks.h)

项目
02/29/2024

当客户端请求从事件的通知队列中删除时，将调用 AVStream 微型驱动程序的 AVStrMiniRemoveEvent 例程。此例程是可选的。

语法

PFNKSREMOVEEVENT Pfnksremoveevent;

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

参数

[in] FileObject

指向要删除其事件的文件对象的指针。

[in] EventEntry

指向 AVStream 生成的 KSEVENT_ENTRY 结构的指针。

返回值

无

备注

微型驱动程序在 KSEVENT_ITEM 结构的 RemoveHandler 成员中指定此例程的地址。 AVStream 中的事件处理描述了微型驱动程序如何向类驱动程序提供此结构。

如果微型驱动程序提供 AVStrMiniRemoveEvent，并且未指定 AddHandler 或指定调用 KsXxxAddEvent 的 AddHandler，则微型驱动程序的 AVStrMiniRemoveEvent 必须使用指向 KSEVENT_ENTRY 结构中LIST_ENTRY结构的指针调用 RemoveEntryList：

&EventEntry -> ListEntry

否则， AVStrMiniRemoveEvent 应反转 AddHandler 中执行的步骤。

要求

要求	值
最低受支持的客户端	适用于 Microsoft Windows XP 及更高版本的操作系统以及 DirectX 8.0 及更高版本的 DirectX。
目标平台	桌面
标头	ks.h (包括 Ks.h)