VideoPortMapDmaMemory 函数 (video.h)

VideoPortMapDmaMemory 函数在 Windows 2000 及更高版本中已过时。

VideoPortMapDmaMemory 映射一系列用于 DMA 传输的内存。

语法

VIDEOPORT_DEPRECATED VIDEOPORT_API PDMA VideoPortMapDmaMemory(
  [in]      IN PVOID                 HwDeviceExtension,
  [in]      IN PVIDEO_REQUEST_PACKET pVrp,
  [in]      IN PHYSICAL_ADDRESS      BoardAddress,
  [in]      IN PULONG                Length,
  [in]      IN PULONG                InIoSpace,
  [in]      IN PVOID                 MappedUserEvent,
  [in]      IN PVOID                 DisplayDriverEvent,
  [in, out] IN OUT PVOID             *VirtualAddress
);

参数

[in] HwDeviceExtension

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

[in] pVrp

指向 VIDEO_REQUEST_PACKET的指针。

[in] BoardAddress

指定适配器的起始地址。

[in] Length

指定内存范围的长度（以字节为单位）。

[in] InIoSpace

指示区域的位置。 此参数可能是以下值之一：

值	含义
VIDEO_MEMORY_SPACE_DENSE	内存是密集映射和线性的。
VIDEO_MEMORY_SPACE_IO	范围位于系统 I/O 空间中。 不应由显示驱动程序设置。
VIDEO_MEMORY_SPACE_MEMORY	该范围位于内存空间中。 不应由显示驱动程序设置。
VIDEO_MEMORY_SPACE_P6CACHE	P6 MTRR 缓存，等效于写合并缓存。 (内核模式和用户模式) 。
VIDEO_MEMORY_SPACE_USER_MODE	应用程序使用的内存指针。

[in] MappedUserEvent

保留供系统使用。

[in] DisplayDriverEvent

保留供系统使用。

[in, out] VirtualAddress

保留供系统使用。

返回值

VideoPortMapDmaMemory 始终返回 NULL。

注解

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

要求

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