PFNKSSTREAMPOINTER 回调函数 (ks.h)

AVStream 在取消与克隆流指针关联的 IRP 时调用微型驱动程序的 AVStrMiniCancelCallback 例程。 此例程是可选的。

语法

PFNKSSTREAMPOINTER Pfnksstreampointer;

void Pfnksstreampointer(
  [in] PKSSTREAM_POINTER StreamPointer
)
{...}

参数

[in] StreamPointer

指向与取消的 IRP 关联的克隆 KSSTREAM_POINTER 的指针。 StreamPointer 是通过调用 KsStreamPointerClone创建的。

返回值

没有

言论

minidriver 在 KsStreamPointerCloneCancelCallback 参数中指定此例程的地址。

AVStrMiniCancelCallback中,微型驱动程序应将所有引用都设置为克隆指针,以 NULL

此外,微型驱动程序应删除与克隆指针相关的任何上下文信息,并通知硬件有关取消的信息。

最后,微型驱动程序必须调用 KsStreamPointerDelete 才能删除克隆及其关联的上下文。 如果微型驱动程序未删除克隆,则 IRP 将保留引用计数且未完成,这可能会导致相关应用程序崩溃。

AVStrMiniCancelCallback 调用队列的旋转锁,因此在DISPATCH_LEVEL。 因此,回调例程无法执行队列作或调用获取互斥体的函数。

要求

要求 价值
最低支持的客户端 Microsoft Windows XP 及更高版本的作系统以及 DirectX 8.0 及更高版本的 DirectX 版本中提供。
目标平台 桌面
标头 ks.h (包括 Ks.h)

另请参阅

KSSTREAM_POINTER

KsStreamPointerClone

KsStreamPointerDelete