KsPinRegisterFrameReturnCallback 函数 (ks.h)

  • 项目

KsPinRegisterFrameReturnCallback 函数使用 AVStream 为给定引脚注册帧返回回调。

语法

void KsPinRegisterFrameReturnCallback(
  [in] PKSPIN              Pin,
  [in] PFNKSPINFRAMERETURN FrameReturn
);

参数

[in] Pin

指向要通过注册帧返回回调置于注入模式的 AVStream KSPIN 结构的指针。

[in] FrameReturn

此参数提供微型驱动程序提供的 AVStrMiniFrameReturn 例程的地址。

返回值

无

备注

如果引脚在从KSSTATE_STOP转换到 KSSTATE_ACQUIRE 之前注册了帧返回回调，则引脚将置于注入模式。 这表明引脚不会接收缓冲区并填充缓冲区，而是使用 KsPinSubmitFrame 或 KsPinSubmitFrameMdl 手动将数据帧注入线路。 当数据帧完成其绕线路移动并返回到提交它的引脚时，AVStream 通过调用 AVStrMiniFrameReturn 将其回收。

调用此函数的微型驱动程序直接负责将帧注入线路;它们不接收要填充的缓冲区，也不会像大多数微型驱动程序那样直接与队列交互。 另请注意，应在创建内核管道部分之前注册帧返回回调。 当引脚转换到KSSTATE_ACQUIRE时，将创建内核管道部分。 有关详细信息，请参阅 帧注入。

要求

要求 值
最低受支持的客户端 在 Microsoft Windows XP 及更高版本的操作系统以及 DirectX 8.0 及更高版本的 DirectX 中可用。
目标平台 通用
标头 ks.h (包括 Ks.h)
Library Ks.lib
IRQL PASSIVE_LEVEL

另请参阅

AVStrMiniFrameReturn

KsPinSubmitFrame

KsPinSubmitFrameMdl