PFNKSSTREAMPOINTER 回调函数 (ks.h)

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

语法

PFNKSSTREAMPOINTER Pfnksstreampointer;

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

参数

[in] StreamPointer

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

返回值

备注

微型驱动程序在 KsStreamPointerCloneCancelCallback 参数中指定此例程的地址。

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

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

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

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

要求

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

另请参阅

KSSTREAM_POINTER

KsStreamPointerClone

KsStreamPointerDelete