VideoPortGetCommonBuffer 函数 (video.h)

  • 项目

VideoPortGetCommonBuffer 函数在 Windows XP 及更高版本中已过时，仅出于与现有驱动程序的向后兼容性而受支持。 驱动程序编写器应使用 VideoPortAllocateCommonBuffer。

VideoPortGetCommonBuffer 分配和映射系统内存，以便可以同时从处理器和设备进行通用缓冲区 DMA 操作。

语法

VIDEOPORT_DEPRECATED VIDEOPORT_API PVOID VideoPortGetCommonBuffer(
  [in]  IN PVOID              HwDeviceExtension,
  [in]  IN ULONG              DesiredLength,
  [in]  IN ULONG              Alignment,
  [out] OUT PPHYSICAL_ADDRESS LogicalAddress,
  [out] OUT PULONG            pActualLength,
  [in]  IN BOOLEAN            CacheEnabled
);

参数

[in] HwDeviceExtension

指向微型端口驱动程序的设备扩展的指针。

[in] DesiredLength

指定请求的内存字节数。

[in] Alignment

指定缓冲区的请求对齐方式。 视频端口驱动程序当前忽略此参数。

[out] LogicalAddress

指向变量的指针，该变量接收适配器用来访问分配的缓冲区的逻辑地址。

[out] pActualLength

指向一个变量的指针，该变量接收为此请求分配的缓冲区的实际大小（以字节为单位）。

[in] CacheEnabled

指定是否可以缓存分配的内存。

返回值

如果成功，VideoPortGetCommonBuffer 将返回已分配缓冲区的基虚拟地址;否则，如果无法分配缓冲区，则返回 NULL。

注解

有关基于数据包和通用缓冲区 DMA 传输的信息，请参阅 视频微型端口驱动程序中的总线主 DMA。

要求

要求 值
最低受支持的客户端 适用于 Windows 2000 及更高版本的 Windows 操作系统。
目标平台 桌面
标头 video.h (包括 Video.h)
Library Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL

另请参阅

VideoPortAllocateCommonBuffer