struttura VIDEO_MODE_INFORMATION (ntdvertitaeo.h)

La struttura VIDEO_MODE_INFORMATION contiene tutte le informazioni su una modalità di una scheda video.

Sintassi

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;

Members

Length

Specifica la lunghezza, in byte, di questa struttura. Un driver miniport può utilizzare questo valore per determinare la versione di questa struttura.

ModeIndex

Specifica l'indice della modalità specifica da utilizzare in una chiamata al driver miniport.

VisScreenWidth

Specifica il numero di pixel visibili in una linea di analisi orizzontale.

VisScreenHeight

Specifica il numero di righe visibili (o righe di analisi) sullo schermo.

ScreenStride

Specifica il numero di byte tra l'inizio di una riga di analisi e quella successiva.

NumberOfPlanes

Specifica il numero di piani separati combinati dal dispositivo.

BitsPerPlane

Specifica il numero di bit per pixel per piano.

Frequency

Specifica la frequenza di aggiornamento dello schermo, inHz.

XMillimeter

Specifica la larghezza, espressa in millimetri, dell'area attiva nel dispositivo di output.

YMillimeter

Specifica l'altezza, espressa in millimetri, dell'area attiva nel dispositivo di output.

NumberRedBits

Specifica il numero di bit nell'applicazione livello dati rossa.

NumberGreenBits

Specifica il numero di bit nell'applicazione livello dati verde.

NumberBlueBits

Specifica il numero di bit nell'applicazione livello dati blu.

RedMask

Maschera di colore rosso per un dispositivo con modalità colore diretto. Ad esempio, per indicare che i bit da 0 a 4 devono essere usati per il rosso, usare il valore 0x001F.

GreenMask

Maschera di colore verde per un dispositivo con modalità colore diretto. Ad esempio, per indicare che i bit da 5 a 9 devono essere usati per il verde, usare il valore 0x03E0.

BlueMask

Maschera di colore blu per un dispositivo con modalità colore diretto. Ad esempio, per indicare che i bit da 10 a 14 devono essere usati per blu, usare il valore 0x7C00.

AttributeFlags

Set di flag che indicano un determinato comportamento per il dispositivo. I flag e i relativi significati sono illustrati nella tabella seguente.

Nome contrassegno	Valore flag	Numero bit	Valore e significato di bit
VIDEO_MODE_COLOR	0x0001	0	0 = Compatibile con Mono 1 = Colore
VIDEO_MODE_GRAPHICS	0x0002	1	0 = Modalità testo 1 = Grafica
VIDEO_MODE_PALETTE_DRIVEN	0x0004	2	0 = I colori sono diretti 1 = I colori vengono indicizzati in una tavolozza
VIDEO_MODE_MANAGED_PALETTE	0x0008	3	0 = Il riquadro è fisso (deve essere sottoposto a query dal driver miniport) 1 = La tavolozza è impostata
VIDEO_MODE_INTERLACED	0x0010	4	0 = Modalità non interlacciata 1 = Modalità interlacciata
VIDEO_MODE_NO_OFF_SCREEN	0x0020	5	0 = Memoria fuori schermo disponibile 1 = Non è possibile usare la memoria offscreen per archiviare le informazioni
VIDEO_MODE_NO_64_BIT_ACCESS	0x0040	6	0 = le scritture di memoria a 64 bit nel buffer dei frame vengono gestite correttamente 1 = le scritture di memoria a 64 bit nel buffer dei frame non vengono gestite

VideoMemoryBitmapWidth

Specifica la larghezza, in pixel, della bitmap di memoria video.

VideoMemoryBitmapHeight

Specifica l'altezza, in pixel, della bitmap di memoria video.

DriverSpecificAttributeFlags

Set di flag che indicano un determinato comportamento per il dispositivo. Questi flag privati sono definiti nel driver miniport e sono per l'uso solo dai driver miniport e display.

Commenti

Il driver miniport video restituisce una matrice di strutture VIDEO_MODE_INFORMATION in risposta a una richiesta di IOCTL_VIDEO_QUERY_AVAIL_MODES , con ogni struttura contenente informazioni su una modalità dell'adattatore. Il driver miniport restituisce una struttura VIDEO_MODE_INFORMATION che contiene informazioni sulla modalità corrente dell'adattatore in risposta a una richiesta di IOCTL_VIDEO_QUERY_CURRENT_MODE .

Tre membri di VIDEO_MODE_INFORMATION, VisScreenWidth, VideoMemoryBitmapWidth e ScreenStride, sono associati alla larghezza orizzontale dello schermo. Per gli schermi che usano uno o più byte per pixel, questi membri soddisfano la disuguaglianza

VisScreenWidth<= VideoMemoryBitmapWidth<= ScreenStride.

In una relazione simile per l'altezza verticale dello schermo, VisScreenHeight e VideoMemoryBitmapHeight soddisfano la disuguaglianza

VisScreenHeight<= VideoMemoryBitmapHeight.

Requisiti

Requisito	Valore
Intestazione	ntdvertitaeo.h (include Ntdvertitaeo.h)

Vedi anche

IOCTL_VIDEO_QUERY_AVAIL_MODES

IOCTL_VIDEO_QUERY_CURRENT_MODE

VIDEO_MEMORY_INFORMATION