VideoPortAllocateContiguousMemory 函数 (video.h)
VideoPortAllocateContiguousMemory 函数在 Windows 2000 及更高版本中 过时。 视频微型端口驱动程序应在其位置使用 VideoPortAllocateCommonBuffer。
VideoPortAllocateContiguousMemory 从非分页池分配一系列物理连续缓存对齐的内存。
语法
VIDEOPORT_DEPRECATED VIDEOPORT_API PVOID VideoPortAllocateContiguousMemory(
[in] IN PVOID HwDeviceExtension,
[in] IN ULONG NumberOfBytes,
[in] IN PHYSICAL_ADDRESS HighestAcceptableAddress
);
参数
[in] HwDeviceExtension
指向微型端口驱动程序的设备扩展的指针。
[in] NumberOfBytes
指定要分配的连续内存块的大小(以字节为单位)。
[in] HighestAcceptableAddress
指定微型端口驱动程序可以使用的最高有效物理地址。 例如,如果设备只能引用较低 16MB 中的物理内存,则此值将设置为0x00000000FFFFFF。
返回值
VideoPortAllocateContiguousMemory 返回已分配内存的基虚拟地址(如果调用成功)。 如果无法满足请求,则返回 NULL。
言论
VideoPortAllocateContiguousMemory 可以调用,为长期内部缓冲区分配连续的物理内存块。
必须使用连续内存的微型端口驱动程序应仅分配驱动程序初始化期间所需的内存,因为非分页池在系统运行时可能会碎片化。 如果卸载微型端口驱动程序,则必须解除分配内存。 连续分配在处理器数据缓存行大小的整数倍数上对齐,以防止缓存和一致性问题。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 在 Windows 2000 及更高版本的 Windows作系统中可用。 |
目标平台 | 桌面 |
标头 | video.h (include Video.h) |
库 | Videoprt.lib |
DLL | Videoprt.sys |
IRQL | PASSIVE_LEVEL |