VideoPortAllocateCommonBuffer 函数 (video.h)
VideoPortAllocateCommonBuffer 函数分配和映射系统内存,以便可从处理器和设备同时访问它,以便进行通用缓冲区 DMA作。
语法
VIDEOPORT_DEPRECATED VIDEOPORT_API PVOID VideoPortAllocateCommonBuffer(
[in] IN PVOID HwDeviceExtension,
[in] IN PVP_DMA_ADAPTER VpDmaAdapter,
[in] IN ULONG DesiredLength,
[out] OUT PPHYSICAL_ADDRESS LogicalAddress,
[in] IN BOOLEAN CacheEnabled,
[out] OUT PVOID Reserved
);
参数
[in] HwDeviceExtension
指向微型端口驱动程序的设备扩展的指针。
[in] VpDmaAdapter
指向表示总线主适配器的 VP_DMA_ADAPTER 结构的指针。 此结构是由上一次调用 videoPortGetDmaAdapter返回的。
[in] DesiredLength
指定请求的内存字节数。
[out] LogicalAddress
指向接收适配器用于访问分配缓冲区的逻辑地址的内存位置的指针。
[in] CacheEnabled
指定是否可以缓存分配的内存。 有关详细信息,请参阅 AllocateCommonBufferCacheEnabled 参数的说明。
[out] Reserved
视频端口驱动程序当前忽略;应设置为 NULL。
返回值
VideoPortAllocateCommonBuffer 如果成功,则返回已分配缓冲区的基虚拟地址;否则,如果无法分配缓冲区,它将返回 NULL。
言论
不再需要缓冲区时,视频微型端口驱动程序应通过调用 VideoPortReleaseCommonBuffer来释放它。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 在 Windows XP 和更高版本的 Windows作系统中可用。 |
目标平台 | 桌面 |
标头 | video.h (include Video.h) |
库 | Videoprt.lib |
DLL | Videoprt.sys |
IRQL | PASSIVE_LEVEL |