structure VIDEO_MODE_INFORMATION (ntddvdeo.h)

Article
07/16/2024

La structure VIDEO_MODE_INFORMATION contient toutes les informations relatives à un mode d’adaptateur vidéo.

Syntaxe

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;

Membres

Length

Spécifie la longueur, en octets, de cette structure. Un pilote miniport peut utiliser cette valeur pour déterminer la version de cette structure.

ModeIndex

Spécifie l’index du mode particulier à utiliser dans un appel au pilote miniport.

VisScreenWidth

Spécifie le nombre de pixels visibles sur une ligne d’analyse horizontale.

VisScreenHeight

Spécifie le nombre de lignes visibles (ou de lignes d’analyse) à l’écran.

ScreenStride

Spécifie le nombre d’octets entre le début d’une ligne d’analyse et le suivant.

NumberOfPlanes

Spécifie le nombre de plans distincts combinés par l’appareil.

BitsPerPlane

Spécifie le nombre de bits par pixel par plan.

Frequency

Spécifie le taux d’actualisation de l’écran, dans Hertz.

XMillimeter

Spécifie la largeur, en millimètres, de la région active sur l’appareil de sortie.

YMillimeter

Spécifie la hauteur, en millimètres, de la région active sur l’appareil de sortie.

NumberRedBits

Spécifie le nombre de bits dans la DAC rouge.

NumberGreenBits

Spécifie le nombre de bits dans la DAC verte.

NumberBlueBits

Spécifie le nombre de bits dans la DAC bleue.

RedMask

Masque de couleur rouge pour un appareil avec des modes de couleur directe. Par exemple, pour indiquer que les bits 0 à 4 doivent être utilisés pour le rouge, utilisez la valeur 0x001F.

GreenMask

Masque de couleur verte pour un appareil avec des modes de couleur directe. Par exemple, pour indiquer que les bits 5 à 9 doivent être utilisés pour le vert, utilisez la valeur 0x03E0.

BlueMask

Masque de couleur bleu pour un appareil avec des modes de couleur directe. Par exemple, pour indiquer que les bits 10 à 14 doivent être utilisés pour le bleu, utilisez la valeur 0x7C00.

AttributeFlags

Ensemble d’indicateurs indiquant un certain comportement pour l’appareil. Les indicateurs et leurs significations sont indiqués dans le tableau suivant.

nom de l’indicateur	valeur d’indicateur	nombre de bits	valeur et signification
VIDEO_MODE_COLOR	0x0001	0	0 = Compatible mono 1 = Couleur
VIDEO_MODE_GRAPHICS	0x0002	1	0 = Mode texte 1 = Graphiques
VIDEO_MODE_PALETTE_DRIVEN	0x0004	2	0 = Les couleurs sont directes 1 = Les couleurs sont indexées dans une palette de
VIDEO_MODE_MANAGED_PALETTE	0x0008	3	0 = Palette est fixe (doit être interrogé à partir du pilote miniport) 1 = Palette est paramétrable
VIDEO_MODE_INTERLACED	0x0010	4	0 = Mode non entrelacé 1 = Mode entrelacé
VIDEO_MODE_NO_OFF_SCREEN	0x0020	5	0 = Mémoire hors écran disponible 1 = La mémoire hors écran ne peut pas être utilisée pour stocker des informations
VIDEO_MODE_NO_64_BIT_ACCESS	0x0040	6	0 = écritures de mémoire 64 bits dans mémoire tampon d’images sont gérées correctement 1 = écritures de mémoire 64 bits dans la mémoire tampon d’images ne sont pas gérées

VideoMemoryBitmapWidth

Spécifie la largeur, en pixels, de la bitmap de mémoire vidéo.

VideoMemoryBitmapHeight

Spécifie la hauteur, en pixels, de la bitmap de mémoire vidéo.

DriverSpecificAttributeFlags

Ensemble d’indicateurs indiquant un certain comportement pour l’appareil. Ces indicateurs privés sont définis dans le pilote miniport et sont utilisés uniquement par le miniport et les pilotes d’affichage.

Remarques

Le pilote miniport vidéo retourne un tableau de structures VIDEO_MODE_INFORMATION en réponse à une requête IOCTL_VIDEO_QUERY_AVAIL_MODES, avec chaque structure contenant des informations sur un mode de l’adaptateur. Le pilote miniport retourne une structure VIDEO_MODE_INFORMATION qui contient des informations sur le mode actuel de l’adaptateur en réponse à une demande de IOCTL_VIDEO_QUERY_CURRENT_MODE.

Trois membres de VIDEO_MODE_INFORMATION, VisScreenWidth, VideoMemoryBitmapWidthet ScreenStride, sont associés à la largeur horizontale de l’écran. Pour les affichages qui utilisent un ou plusieurs octets par pixel, ces membres répondent à l’inégalité
VisScreenWidth<= VideoMemoryBitmapWidth<= ScreenStride.

Dans une relation similaire pour la hauteur verticale de l’écran, VisScreenHeight et VideoMemoryBitmapHeight satisfaire l’inégalité
VisScreenHeight<= VideoMemoryBitmapHeight.

Exigences

Exigence	Valeur
d’en-tête	ntddvdeo.h (include Ntddvdeo.h)

Voir aussi

IOCTL_VIDEO_QUERY_AVAIL_MODES

IOCTL_VIDEO_QUERY_CURRENT_MODE

VIDEO_MEMORY_INFORMATION

Partager via