KsPinAttemptProcessing 函数 (ks.h)

  • 项目

KsPinAttemptProcessing 函数用于恢复以引脚为中心的筛选器上特定引脚上的处理。 它尝试通过向 Pin 的处理对象发送处理调度调用来启动 Pin 上的处理。

语法

void KsPinAttemptProcessing(
  [in] PKSPIN  Pin,
  [in] BOOLEAN Asynchronous
);

参数

[in] Pin

指向 KSPIN 结构的指针，该结构表示要尝试处理的 AVStream 引脚对象。

警告

此参数是必需的。 如果调用 Pin 值为NULL 的 KsPinAttemptProcessing，可能会导致系统不稳定。

[in] Asynchronous

此参数指示微型驱动程序的首选项，处理应同步还是异步进行。 如果 为 TRUE，则处理始终是异步的。 但是，同步处理仅在特定情况下发生。 有关详细信息，请参阅下面的“备注”部分。

返回值

无

备注

微型驱动程序可能需要调用 KsPinAttemptProcessing 才能在各种情况下恢复处理。 例如，如果客户端已使用 KsGateTurnInputOff 关闭处理控制门，请在准备好尝试处理时调用此函数。 请注意，只有当进程控制门处于打开状态时，这才会导致处理调度。 另一种情况涉及微型驱动程序以前将STATUS_PENDING返回到处理调度。 有关详细信息，请参阅 在 AVStream 中重启处理 和 AVStream 中的流控制入口。

处理调度以同步或异步方式发生， 并且仅 当处理控制门处于打开状态时。 异步标志指定微型驱动程序的首选项。 如果微型驱动程序请求异步进程调度，则调度始终是异步的。 但是，即使调用方将 “异步” 设置为 FALSE，也仅当系统当前在低于最大处理 IRQL 的 IRQL 上运行时才会发生同步调度。 换句话说，如果微型驱动程序未指定调度级别处理，并且调用在 IRQL = DISPATCH_LEVEL进行，则调用将在异步工作项PASSIVE_LEVEL发生，而不考虑 异步的值。 有关详细信息，请参阅 以筛选器为中心的处理 和 以引脚为中心的处理。

要求

要求 值
目标平台 通用
标头 ks.h (包括 Ks.h)
Library Ks.lib
IRQL <=DISPATCH_LEVEL (请参阅备注)

另请参阅

KSFILTER_DISPATCH

KsFilterAttemptProcessing

KsGateCaptureThreshold