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 | (请参阅“备注”部分) |