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) |