KsPinRegisterIrpCompletionCallback 函数 (ks.h)
KsPinRegisterIrpCompletionCallback 函数为指定的引脚注册微型驱动程序定义的回调例程。 当 IRP 完成绕线路传递且与 IRP 关联的帧即将回收或停用时,AVStream 会调用微型驱动程序提供的例程。
语法
void KsPinRegisterIrpCompletionCallback(
[in] PKSPIN Pin,
[in] PFNKSPINIRPCOMPLETION IrpCompletion
);
参数
[in] Pin
指向要为其注册完成回调的 KSPIN 结构的指针。
[in] IrpCompletion
此参数提供在 IRP 完成其遍历线路并即将被回收或停用时调用的 AVStrMiniPinIrpCompletion 例程的地址。
返回值
无
备注
在引脚进入KSSTATE_ACQUIRE之前,必须在 IRQL=PASSIVE_LEVEL 调用 KsPinRegisterIrpCompletionCallback。 有关引脚状态的详细信息,请参阅 KSSTATE。
此函数经常从引脚创建调度调用。 请参阅 KSPIN_DISPATCH。
KsPinRegisterIrpCompletionCallback 仅在 IRP 源引脚上有用,通常用于数据源引脚。 对于数据源引脚,在 IRP 完成回到引脚并即将回收后,将进行回调。 但是,对于数据接收器引脚,回调不直接绑定到 IRP 完成。 当 IRP 返回回收时,AVStream 仍会进行回调。 在 IRP 通过需要使用它包含的数据的所有队列之前,不会发生此返回。 有关 IRP 源/接收器引脚与数据源/接收器引脚的信息,请参阅KSPIN_DESCRIPTOR结构的数据流和通信成员。
KsPinRegisterIrpCompletionCallback 与 KsPinRegisterFrameReturnCallback 明显不同,此例程不会将引脚置于任何新模式;它只是注册回调例程。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 Microsoft Windows XP 及更高版本的操作系统以及 DirectX 8.0 及更高版本的 DirectX 中可用。 |
目标平台 | 通用 |
标头 | ks.h (包括 Ks.h) |
Library | Ks.lib |
IRQL | PASSIVE_LEVEL |