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 |