KsPinRegisterIrpCompletionCallback 函数注册指定引脚的微型驱动程序定义的回调例程。 AVStream 在 IRP 完成线路周围的传递和与 IRP 关联的帧即将回收或停用时,会调用微型驱动程序提供的例程。
语法
void KsPinRegisterIrpCompletionCallback(
[in] PKSPIN Pin,
[in] PFNKSPINIRPCOMPLETION IrpCompletion
);
参数
[in] Pin
指向要为其注册完成回调的 KSPIN 结构的指针。
[in] IrpCompletion
此参数提供 AVStrMiniPinIrpCompletion 例程的地址,当 IRP 完成线路遍历并即将回收或停用时调用该例程。
返回值
没有
言论
KsPinRegisterIrpCompletionCallback 必须在 IRQL=PASSIVE_LEVEL调用,然后引脚才会进入KSSTATE_ACQUIRE。 有关引脚状态的详细信息,请参阅 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) |
库 | Ks.lib |
IRQL | PASSIVE_LEVEL |