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

另请参阅

KSFILTER_DISPATCH

KSGATE

KsGateCaptureThreshold

KsPinAttemptProcessing