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） |
| 库 | Ks.lib |
| IRQL | PASSIVE_LEVEL |