PFNKSPININITIALIZEALLOCATOR 回调函数 (ks.h)

AVStream 微型驱动程序的 AVStrMiniInitializeAllocator 例程初始化将与引脚关联的分配器。

语法

PFNKSPININITIALIZEALLOCATOR Pfnkspininitializeallocator;

NTSTATUS Pfnkspininitializeallocator(
  [in]  PKSPIN Pin,
  [in]  PKSALLOCATOR_FRAMING AllocatorFraming,
  [out] PVOID *Context
)
{...}

参数

[in] Pin

指向 KSPIN 结构的指针,该结构描述分配器要与之关联的引脚。

[in] AllocatorFraming

指向描述分配器应使用的框架要求的 KSALLOCATOR_FRAMING 结构的指针。

[out] Context

指向分配器的上下文的指针,该分配器将作为参数传递给此结构的其他例程。 例如,驱动程序可以存储引脚或分配器框架结构,供其他回调例程稍后引用。 请注意, KSALLOCATOR_DISPATCH 的其他例程必须至少具有引用 Pin 的间接方式。 (例如,AVStrMiniAllocate 需要能够访问 PinAllocatorFraming 信息,Context 是 AVStream 传递它的唯一参数。)

返回值

AVStrMiniInitializeAllocator 应返回STATUS_SUCCESS或尝试创建分配器时收到的错误代码。

注解

微型驱动程序在其KSALLOCATOR_DISPATCH结构的 InitializeAllocator 成员中指定此例程的地址。 微型驱动程序将此结构传递给 KSPIN_DISPATCH 中的类驱动程序。

请注意,内核模式分配器无法分配最终可能达到用户模式的帧。

AVStream 调用 AVStrMiniInitializeAllocator 来初始化给定的分配器。 此例程的处理程序应准备好处理内存分配和释放请求。

有关详细信息,请参阅 KS 分配器

要求

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

另请参阅

AVStrMiniDeleteAllocator

KSALLOCATOR_DISPATCH

KSALLOCATOR_FRAMING

KSPIN

KSPIN_DISPATCH