VIDEO_MODE_INFORMATION structure (ntddvdeo.h)

  • Article

La structure VIDEO_MODE_INFORMATION contient toutes les informations sur un mode d’une carte 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 de balayage horizontale.

VisScreenHeight

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

ScreenStride

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

NumberOfPlanes

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

BitsPerPlane

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

Frequency

Spécifie la fréquence d’actualisation de l’écran, en 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 le périphérique 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 bleue 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 présentés dans le tableau suivant.

Nom de l’indicateur Valeur de l’indicateur Numéro de bits Valeur de bits et signification
VIDEO_MODE_COLOR 0x0001 0 0 = monocompatible
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
VIDEO_MODE_MANAGED_PALETTE 0x0008 3 0 = La palette est fixe (doit être interrogée à partir du pilote miniport)
1 = La palette est paramétrable
VIDEO_MODE_INTERLACED 0x0010 4 0 = mode non entrelacé
1 = mode entrelacé
VIDEO_MODE_NO_OFF_SCREEN 0x0020 5 0 = la mémoire hors écran est 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 = les écritures mémoire 64 bits dans la mémoire tampon de trame sont gérées correctement
1 = les écritures mémoire 64 bits dans la mémoire tampon de trame ne sont pas gérées

VideoMemoryBitmapWidth

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

VideoMemoryBitmapHeight

Spécifie la hauteur, en pixels, de la bitmap de la 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 destinés uniquement aux pilotes de miniport et d’affichage.

Remarques

Le pilote de miniport vidéo retourne un tableau de structures VIDEO_MODE_INFORMATION en réponse à une demande de IOCTL_VIDEO_QUERY_AVAIL_MODES , 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, VideoMemoryBitmapWidth et 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 répondent à l’inégalité
VisScreenHeight<= VideoMemoryBitmapHeight.

Configuration requise

Condition requise Valeur
En-tête ntddvdeo.h (incluez Ntddvdeo.h)

Voir aussi

IOCTL_VIDEO_QUERY_AVAIL_MODES

IOCTL_VIDEO_QUERY_CURRENT_MODE

VIDEO_MEMORY_INFORMATION