KsPinRegisterIrpCompletionCallback 函数 (ks.h)

项目
02/26/2024

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