Condividi tramite


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;

Membri

Length

Specifica la lunghezza, espressa in byte, di questa struttura. Un driver miniport può usare 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 su 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 rosso.

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 il 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 flag valore flag numero di bit valore bit e significato
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 a una tavolozza
VIDEO_MODE_MANAGED_PALETTE 0x0008 3 0 = La tavolozza è fissa (deve essere eseguita una query dal driver miniport)
1 = La tavolozza è impostabile
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 = scritture di memoria a 64 bit in buffer frame vengono gestite correttamente
1 = le scritture di memoria a 64 bit nel buffer dei frame non vengono gestite

VideoMemoryBitmapWidth

Specifica la larghezza, espressa 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 solo per l'uso da miniport e driver di visualizzazione.

Osservazioni

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, VideoMemoryBitmapWidthe ScreenStride, sono associati alla larghezza dello schermo orizzontale. Per visualizzare 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 soddisfare la disuguaglianza
VisScreenHeight<= VideoMemoryBitmapHeight.

Fabbisogno

Requisito Valore
intestazione ntd troppe.h (include Ntdvertitaeo.h)

Vedere anche

IOCTL_VIDEO_QUERY_AVAIL_MODES

IOCTL_VIDEO_QUERY_CURRENT_MODE

VIDEO_MEMORY_INFORMATION