KsFilterAttemptProcessing 函数 (ks.h)
KsFilterAttemptProcessing 函数尝试在 Filter 上启动处理。
语法
void KsFilterAttemptProcessing(
[in] PKSFILTER Filter,
[in] BOOLEAN Asynchronous
);
参数
[in] Filter
指向 KSFILTER 结构的指针,该结构表示要尝试处理的 AVStream 筛选器对象。
[in] Asynchronous
此参数包含一个指示,指示处理调度是否应异步发生 () 发生。 如果为 TRUE,则保证异步调度;但是,同步处理调度受下述条件的约束。
返回值
无
备注
如果微型驱动程序在满足处理数据所需的所有条件时调用 KsFilterAttemptProcessing ,则会发生处理调度。 有关进程回调的详细信息,请参阅 KSFILTER_DISPATCH。 为了使尝试产生实际调度,筛选器的进程控制门必须处于打开状态。 与以引脚为中心的处理不同,以筛选器为中心的处理有许多影响过程控制门的条件。 有关这些要求的详细信息,请参阅 以筛选器为中心的处理 和 以引脚为中心的处理。
如果进程控制门处于打开状态,则会以同步或异步方式进行处理调度。 如果调用方在异步参数中指定 TRUE,则处理调度始终在工作项中异步发生。 但是,如果调用方请求同步处理调度,则仅当系统当前位于微型驱动程序可以处理处理的 IRQL 时,才会同步调度。 如果系统处于PASSIVE_LEVEL,则保证调度同步进行。 相反,如果系统处于DISPATCH_LEVEL,则仅当在筛选器上指定了KSFILTER_FLAG_DISPATCH_LEVEL_PROCESSING时,调度才会同步进行。 否则,工作项将排队以执行处理。
请注意,这只是处理尝试;调用此函数并不保证会开始处理。 仅当进程控制门为“打开”时,才会进行处理。有关详细信息,请参阅 在 AVStream 中重启处理 和 AVStream 中的流控制入口。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 适用于 Microsoft Windows XP 及更高版本的操作系统以及 DirectX 8.0 及更高版本的 DirectX。 |
目标平台 | 通用 |
标头 | ks.h (包括 Ks.h) |
Library | Ks.lib |
IRQL | <=DISPATCH_LEVEL |