KsPinRegisterIrpCompletionCallback 函数 (ks.h)

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

另请参阅

AVStrMiniPinCreate

AVStrMiniPinIrpCompletion

KSPIN

KSPIN_DISPATCH

KSSTATE

KsPinRegisterFrameReturnCallback