VIDEO_MODE_INFORMATION 结构 (ntddvdeo.h)

  • 项目

VIDEO_MODE_INFORMATION结构包含有关视频适配器的一种模式的所有信息。

语法

typedef struct _VIDEO_MODE_INFORMATION {
  ULONG Length;
  ULONG ModeIndex;
  ULONG VisScreenWidth;
  ULONG VisScreenHeight;
  ULONG ScreenStride;
  ULONG NumberOfPlanes;
  ULONG BitsPerPlane;
  ULONG Frequency;
  ULONG XMillimeter;
  ULONG YMillimeter;
  ULONG NumberRedBits;
  ULONG NumberGreenBits;
  ULONG NumberBlueBits;
  ULONG RedMask;
  ULONG GreenMask;
  ULONG BlueMask;
  ULONG AttributeFlags;
  ULONG VideoMemoryBitmapWidth;
  ULONG VideoMemoryBitmapHeight;
  ULONG DriverSpecificAttributeFlags;
} VIDEO_MODE_INFORMATION, *PVIDEO_MODE_INFORMATION;

成员

Length

指定此结构的长度（以字节为单位）。 微型端口驱动程序可以使用此值来确定此结构的版本。

ModeIndex

指定要在调用微型端口驱动程序时使用的特定模式的索引。

VisScreenWidth

指定一条水平扫描线上可见像素的数目。

VisScreenHeight

指定屏幕上) (可见行数或扫描行数。

ScreenStride

指定一个扫描行的开头和下一个扫描行之间的字节数。

NumberOfPlanes

指定由设备组合的单独平面数。

BitsPerPlane

指定每个平面每像素的位数。

Frequency

指定屏幕刷新率（以 Hertz 为单位）。

XMillimeter

指定输出设备上活动区域的宽度（以毫米为单位）。

YMillimeter

指定输出设备上活动区域的高度（以毫米为单位）。

NumberRedBits

指定红色 DAC 中的位数。

NumberGreenBits

指定绿色 DAC 中的位数。

NumberBlueBits

指定蓝色 DAC 中的位数。

RedMask

具有直接颜色模式的设备的红色掩码。 例如，若要指示 0 到 4 位用于红色，请使用值0x001F。

GreenMask

具有直接颜色模式的设备绿色掩码。 例如，若要指示将位 5 到 9 用于绿色，请使用值 0x03E0。

BlueMask

直接颜色模式设备的蓝色蒙板。 例如，若要指示 10 到 14 位用于蓝色，请使用值 0x7C00。

AttributeFlags

指示设备的特定行为的一组标志。 下表显示了标志及其含义。

标志名称 标志值 位号 位值和含义
VIDEO_MODE_COLOR 0x0001 0 0 = 单声道兼容
1 = 颜色
VIDEO_MODE_GRAPHICS 0x0002 1 0 = 文本模式
1 = 图形
VIDEO_MODE_PALETTE_DRIVEN 0x0004 2 0 = 颜色是直接的
1 = 将颜色索引到 调色板
VIDEO_MODE_MANAGED_PALETTE 0x0008 3 0 = 调色板固定 (必须从微型端口驱动程序)
1 = 调色板可设置
VIDEO_MODE_INTERLACED 0x0010 4 0 = 非交错模式
1 = 交错模式
VIDEO_MODE_NO_OFF_SCREEN 0x0020 5 0 = 屏幕外内存可用
1 = 屏幕外内存不能用于存储信息
VIDEO_MODE_NO_64_BIT_ACCESS 0x0040 6 0 = 正确处理对 帧缓冲区 的 64 位内存写入
1 = 不处理对帧缓冲区的 64 位内存写入

VideoMemoryBitmapWidth

指定视频内存位图的宽度（以像素为单位）。

VideoMemoryBitmapHeight

指定视频内存位图的高度（以像素为单位）。

DriverSpecificAttributeFlags

指示设备的特定行为的一组标志。 这些专用标志在微型端口驱动程序中定义，仅供微型端口和显示驱动程序使用。

注解

视频微型端口驱动程序返回VIDEO_MODE_INFORMATION结构数组以响应 IOCTL_VIDEO_QUERY_AVAIL_MODES 请求，每个结构包含有关适配器的一种模式的信息。 微型端口驱动程序返回一个VIDEO_MODE_INFORMATION结构，其中包含有关适配器的当前模式的信息，以响应 IOCTL_VIDEO_QUERY_CURRENT_MODE 请求。

VIDEO_MODE_INFORMATION的三个成员 VisScreenWidth、 VideoMemoryBitmapWidth 和 ScreenStride 与水平屏幕宽度相关联。 对于每个像素使用一个或多个字节的显示器，这些成员满足不相等性
VisScreenWidth<= VideoMemoryBitmapWidth<= ScreenStride。
在垂直屏幕高度的类似关系中， VisScreenHeight 和 VideoMemoryBitmapHeight 满足不相等性
VisScreenHeight<= VideoMemoryBitmapHeight。

要求

要求 值
Header ntddvdeo.h (包括 Ntddvdeo.h)

另请参阅

IOCTL_VIDEO_QUERY_AVAIL_MODES

IOCTL_VIDEO_QUERY_CURRENT_MODE

VIDEO_MEMORY_INFORMATION