estructura VIDEO_MODE_INFORMATION (ntddvdeo.h)

Artículo
07/16/2024

La estructura VIDEO_MODE_INFORMATION contiene toda la información sobre un modo de un adaptador de vídeo.

Sintaxis

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;

Miembros

Length

Especifica la longitud, en bytes, de esta estructura. Un controlador de miniport puede usar este valor para determinar la versión de esta estructura.

ModeIndex

Especifica el índice del modo determinado que se va a usar en una llamada al controlador de miniport.

VisScreenWidth

Especifica el número de píxeles visibles en una línea de examen horizontal.

VisScreenHeight

Especifica el número de líneas visibles (o líneas de examen) en la pantalla.

ScreenStride

Especifica el número de bytes entre el inicio de una línea de examen y la siguiente.

NumberOfPlanes

Especifica el número de planos independientes combinados por el dispositivo.

BitsPerPlane

Especifica el número de bits por píxel por plano.

Frequency

Especifica la frecuencia de actualización de pantalla, en Hertz.

XMillimeter

Especifica el ancho, en milímetros, de la región activa en el dispositivo de salida.

YMillimeter

Especifica el alto, en milímetros, de la región activa en el dispositivo de salida.

NumberRedBits

Especifica el número de bits en la DAC roja.

NumberGreenBits

Especifica el número de bits de la DAC verde.

NumberBlueBits

Especifica el número de bits de la DAC azul.

RedMask

Es la máscara de color rojo para un dispositivo con modos de color directo. Por ejemplo, para indicar que se usarán bits de 0 a 4 para rojo, use el valor 0x001F.

GreenMask

Es la máscara de color verde para un dispositivo con modos de color directo. Por ejemplo, para indicar que se usarán bits de 5 a 9 para verde, use el valor 0x03E0.

BlueMask

Es la máscara de color azul para un dispositivo con modos de color directo. Por ejemplo, para indicar que se usarán bits de 10 a 14 para azul, use el valor 0x7C00.

AttributeFlags

Es un conjunto de marcas que indica cierto comportamiento para el dispositivo. Las marcas y sus significados se muestran en la tabla siguiente.

nombre de marca	de valor de marca de	número de bits de	valor de bits y significado
VIDEO_MODE_COLOR	0x0001	0	0 = Compatible con Mono 1 = Color
VIDEO_MODE_GRAPHICS	0x0002	1	0 = Modo de texto 1 = Gráficos
VIDEO_MODE_PALETTE_DRIVEN	0x0004	2	0 = Los colores son directos 1 = Los colores se indexan en una paleta de
VIDEO_MODE_MANAGED_PALETTE	0x0008	3	0 = La paleta es fija (debe consultarse desde el controlador de miniport) 1 = La paleta es settable
VIDEO_MODE_INTERLACED	0x0010	4	0 = modo no entrelazado 1 = modo entrelazado
VIDEO_MODE_NO_OFF_SCREEN	0x0020	5	0 = Memoria desactivada está disponible 1 = No se puede usar la memoria desactivada para almacenar información
VIDEO_MODE_NO_64_BIT_ACCESS	0x0040	6	0 = escrituras de memoria de 64 bits en de búfer de fotogramas se controlan correctamente 1 = no se controlan las escrituras de memoria de 64 bits en el búfer de fotogramas

VideoMemoryBitmapWidth

Especifica el ancho, en píxeles, del mapa de bits de memoria de vídeo.

VideoMemoryBitmapHeight

Especifica el alto, en píxeles, del mapa de bits de memoria de vídeo.

DriverSpecificAttributeFlags

Es un conjunto de marcas que indica cierto comportamiento para el dispositivo. Estas marcas privadas se definen en el controlador de minipuerto y solo las usan los controladores de miniporte y de visualización.

Observaciones

El controlador de miniporte de vídeo devuelve una matriz de estructuras de VIDEO_MODE_INFORMATION en respuesta a una solicitud de IOCTL_VIDEO_QUERY_AVAIL_MODES, con cada estructura que contiene información sobre un modo del adaptador. El controlador miniport devuelve una estructura VIDEO_MODE_INFORMATION que contiene información sobre el modo actual del adaptador en respuesta a una solicitud de IOCTL_VIDEO_QUERY_CURRENT_MODE.

Tres miembros de VIDEO_MODE_INFORMATION, VisScreenWidth, VideoMemoryBitmapWidth, y ScreenStride, están asociados con el ancho de pantalla horizontal. Para las pantallas que usan uno o más bytes por píxel, estos miembros satisfacen la desigualdad.
VisScreenWidth<= VideoMemoryBitmapWidth<= ScreenStride.

En una relación similar para el alto de la pantalla vertical, VisScreenHeight y VideoMemoryBitmapHeight satisfacer la desigualdad
VisScreenHeight<= VideoMemoryBitmapHeight.

Requisitos

Requisito	Valor
encabezado de	ntddvdeo.h (include Ntddvdeo.h)

Consulte también

IOCTL_VIDEO_QUERY_AVAIL_MODES

IOCTL_VIDEO_QUERY_CURRENT_MODE

VIDEO_MEMORY_INFORMATION

Compartir a través de