PFNKSFILTERPROCESS 回调函数 (ks.h)

当筛选器用于处理帧时,将调用 AVStream 微型驱动程序的 AVStrMiniFilterProcess 例程。 它用于执行 Filter-Centric 处理

语法

PFNKSFILTERPROCESS Pfnksfilterprocess;

NTSTATUS Pfnksfilterprocess(
  [in] PKSFILTER Filter,
       PKSPROCESSPIN_INDEXENTRY Index
)
{...}

参数

[in] Filter

指向必须处理帧的 KSFILTER 结构的指针。

Index

指向 AVStream 按固定 ID 排序的 KSPROCESSPIN_INDEXENTRY 结构的数组的指针。

返回值

返回STATUS_SUCCESS以继续处理。 返回STATUS_PENDING以停止处理,直到下一个触发事件。 微型驱动程序可能会返回错误代码,但将按STATUS_PENDING所述进行处理。

言论

微型驱动程序在其 KSFILTER_DISPATCH 结构的 Process 成员中指定此例程的地址。

例程在 IRQL = DISPATCH_LEVEL 或PASSIVE_LEVEL调用,具体取决于筛选器描述符中表示的首选项。 指定KSFILTER_FLAG_DISPATCH_LEVEL_PROCESSING的筛选器描述符可能在DISPATCH_LEVEL处具有其进程回调;未指定此标志的筛选器描述符将在PASSIVE_LEVEL具有其进程回调。

有关详细信息,请参阅 Filter-Centric 处理在 AVStream中重启处理。

此例程是可选的。

要求

要求 价值
最低支持的客户端 Microsoft Windows XP 及更高版本的作系统以及 DirectX 8.0 及更高版本的 DirectX 版本中提供。
目标平台 桌面
标头 ks.h (包括 Ks.h)
IRQL (请参阅“备注”部分)

另请参阅

KSFILTER_DISPATCH

KSPROCESSPIN_INDEXENTRY