PFNKSSTREAMPOINTER 回调函数 (ks.h)
AVStream 在取消与克隆流指针关联的 IRP 时调用微型驱动程序的 AVStrMiniCancelCallback 例程。 此例程是可选的。
语法
PFNKSSTREAMPOINTER Pfnksstreampointer;
void Pfnksstreampointer(
[in] PKSSTREAM_POINTER StreamPointer
)
{...}
参数
[in] StreamPointer
指向与取消的 IRP 关联的克隆 KSSTREAM_POINTER 的指针。 StreamPointer 是通过调用 KsStreamPointerClone创建的。
返回值
没有
言论
minidriver 在 KsStreamPointerClone的 CancelCallback 参数中指定此例程的地址。
在 AVStrMiniCancelCallback中,微型驱动程序应将所有引用都设置为克隆指针,以 NULL。
此外,微型驱动程序应删除与克隆指针相关的任何上下文信息,并通知硬件有关取消的信息。
最后,微型驱动程序必须调用 KsStreamPointerDelete 才能删除克隆及其关联的上下文。 如果微型驱动程序未删除克隆,则 IRP 将保留引用计数且未完成,这可能会导致相关应用程序崩溃。
AVStrMiniCancelCallback 调用队列的旋转锁,因此在DISPATCH_LEVEL。 因此,回调例程无法执行队列作或调用获取互斥体的函数。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Microsoft Windows XP 及更高版本的作系统以及 DirectX 8.0 及更高版本的 DirectX 版本中提供。 |
目标平台 | 桌面 |
标头 | ks.h (包括 Ks.h) |