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